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NEW RELEASES, VERSIONS, AND A WARNING 


Any programming endeavor of the magnitude of the MDBS software will 
necessarily continue to evolve over time. Realizing this. Micro Data 
Base Systems, Inc., vows to provide its users with updates to this 
version for a nominal handling fee. 

New versions of MDBS software will be considered as separate products. 
However, bona fide owners of previous versions are generally entitled 
to a preferential rate structure. 

Finally, each copy of our software is personalized to identify the 
licensee. There are several levels of this personalization, some of 
which involve encryption methods guaranteed to be combinator ially 
difficult to decipher. Our products have been produced with a very 
substantial investment of capital and labor, to say nothing of the 
years of prior involvement in the data base management area by our 
principals. Accordingly, we are seriously concerned about any 
unauthorized copying of our products and will take any and all 
available legal action against illegal copying or distribution of our 
products. 
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I. OVERVIEW 


A. Organization 

The MDBS RDL Manual describes the optional RDL module of the MDBS 
III data base management system.* It is assumed that the reader is 
familiar with the postrelational , extended-network schemas supported 
by MDBS. Knowledge of the other MDBS languages for data base 
processing (e.g., DML, QRS, IDML) is not required in order to use the 
Report Definition Language. However, familiarity with QRS will 
facilitate the process of learning to use RDL, since RDL is designed 
to be consistent with QRS. 

Chapter I of this manual concludes with an introduction to the 
role of RDL in application development. The RDL constructs and 
features available for designing a report are explained in Chapter II. 
Details of the RDL syntax are formally presented in Chapter III. 
Chapter IV explains how to use the RDL Analyzer and the final chapter 
discusses diagnostics that can arise during RDL analysis. 


B. Introduction to RDL 

The Report Definition Language (RDL) is another aid that helps 
magnify the productivity of application system developers who use 
MDBS. A developer uses the RDL to formally specify the 
characteristics of a desired report and the prompting behavior of a 
program that generates that report. An RDL specification is input to 
the RDL Analyzer which checks the specification for consistency and 
syntactic correctness. If no errors are detected, the RDL Analyzer 
automatically generates a complete program which behaves in accordance 
with the RDL specifications. The resultant program contains the DML 
commands needed to generate the desired report. These are embedded 
within the control structures of a C host language. 

The role of RDL in application system development and usage is 
illustrated in Figure 1-1. RDL enables a report designer who knows 
nothing about DML and C to produce application programs written in C 
and containing all necessary DML logic for extracting and displaying 
desired data from an MDBS data base. A report designer does need to 
know the schema of the data base being used. The generated program 
handles all report formatting as specified with the RDL and can route 
the report to a printer (using preprinted forms, if desired) , a 
console, or a disk file. The generated program will also prompt an 
end user for various information as indicated in the RDL 
specification. An end user's responses serve to initialize variables 
in the generated program at execution time, thereby allowing the end 
user to place conditions on the retrieval of data for the report and 
to control the appearance of the report. 


* MDBS III Version 3.06 (or greater). 
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An RDL specification can have up to seven distinct sections for 

specifying the behavior of the program that is to be generated: 

Identification section 
Prompt section 
Output control section 
Function definition section 
Computed variable section 
Report detail section 
Group section 

The sections must appear in this sequence. All specifications within 

a section are made in a free-form manner. The major characteristics 

of each section are summarized here. 

The identification section is used to declare the name of the 
file or files that will hold the generated program. It is also used 
to indicate the name of the data base which the generated program will 
utilize, a user id for that data base, and that user's password. 

A prompt variable is used to gather information from an end user. 
For each prompt variable declared in the RDL prompt section, the 

generated application program will prompt the end user to enter some 
data which will be used by the program to determine the ultimate 

appearance and content of the report being produced. For instance, 
the data base name, user id, and password might be treated as prompt 
variables. When specifying a prompt variable, the report designer 

gives its name, type, size, and the prompt message that is to be 

presented on the console to an end user. The designer can also 
specify a default value for each prompt variable. Thus, prompt 
variables serve as parameters to the generated application program. 

The output control section is used to specify output page depth, 
left and top margins, pauses in output display, and the device to 
which the output report is to be routed. These can be either 

explicitly declared or they can be handled as prompt variables, 
enabling the end user of the generated program to determine these 
output traits. 

A report designer can optionally specify one or more functions 
that are to be used within the generated program. These are declared 
in the RDL function definition section. A function can have multiple 
input parameters. Within the definition of a function local variables 
can be declared. These, together with global variables (e.g., prompt 
variables) and data items, can be used within assignment statements, 
if-then-else control structures, and test-case control structures 
inside the body of the function. Each function is specified so that 
it returns a single value. 
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Developer-defined functions, together with built-in statistical 
functions (e.g. SUM, AVERAGE), can be used to declare computed 
variables. This is accomplished in the computed variable section. 
Each computed variable is given a name, type and size. In addition, a 
formula is specified, indicating how the item's value is to be 
determined. The formula consists of a function and its arguments. 
For built-in functions, an optional conditional clause can be 
specified. For example, FOR (YTDEARNC10000) SUM (YTDEARN) is a 
formula that says the computed variable's value will be the sum of all 
values of the YTDEARN data item (in the data base) which are less than 
10000 . 

The report detail section defines the content of the report. In 
this section the developer indicates which data items (from the data 
dictionary or screen dictionary) , computed variables, prompt 
variables, and expressions involving any of the former three are to 
have their value (s) appear in the report. The physical position of 
each of these in the output report is specified. This section also 
has an optional FOR clause and a required THRU clause like those that 
appear in a QRS statement. Furthermore, an optional SORT clause can 
be specified to cause the report details to be sorted on various 
criteria. 

The group section allows a developer to specify page breaks and 
various kinds of groupings of report details. Page breaks are stated 
in terms of data items. Whenever a data item's value changes, the 
next report detail is forced to the next report page. Grouping means 
that all report details having some specified characteristics in 
common appear as a group in the output report. Headers and footers 
automatically accompany each group, if desired. Also, automatic 
sorting of groups can be requested. 
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Figure 1-1. The Role of RDL 
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A. Designers and End Users 

A report designer creates an RDL specification which defines the 
appearance and content of a report. The RDL Analyzer is a program 
that accepts an RDL specification as input and generates a program (or 
two programs, in some cases) . After a generated program has been 
compiled, it can be executed by an end user . After prompting the end 
user for various information, the executing program produces a report 
for the end user. In the event that two programs were generated by 
the RDL Analyzer, the first program will produce an intermediate file 
which is then utilized by the second program to produce the final 
report. 

Since the RDL Analyzer produces C source code programs, a 
designer with C programming expertise can modify generated programs if 
desired. 


B. Reports and Pages 

A report consists of one or more pages. A page consists of one 
or more horizontal lines of output. The report designer controls the 
maximum number of lines per report page. The left margin and top 
margin for a report's pages are also determined by the designer. The 
area to the left of the left margin on each page is blank. Similarly, 
nothing appears above a page's top margin. On each page, the first 
line beneath the top margin will (by default) contain the date and the 
page number. If desired, the report designer can suppress this 
automatic display of date and page number. A report can be routed to 
a printer, console screen, and/or disk file. 


C. Report Details 

A report typically contains many re port details . All report 
details within a report have the same structural appearance, but they 
differ in terms of content. Each report detail consists of one or 
more lines containing literals and/or data values. Literals are 
titles, labels, and other strings of characters that do not change 
from one report detail to another. Data values can differ for 
different report details. Data values can be obtained from a data 
base and can be obtained from computations performed by the generated 
program. The positions (both horizontal and vertical) of literals and 
data values within a report detail are controlled by the report 
designer. 
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D. Prompt Variables 

The designer can declare variables whose values are to be 
determined by an end user when the generated program begins executing. 
These are called prompt variables , because the program prompts the end 
user to acquire each variable's value. For each prompt variable, the 
designer specifies what the prompt message will be. A default 
response can also be declared for each prompt variable. 


E. Computed Variables and Functions 

The simplest kind of report detail displays data values that the 
generated program obtained from prompt variables or has retrieved from 
the data base. Beyond this, the designer can define computed 
variables whose values are automatically calculated (and displayed) by 
the generated program for each report detail. A computed variable is 
defined in terms of a function and function arguments. This can be a 
built-in function or a special function created by the report 
designer. 

The seven built-in functions compute various statistics: COUNT, 
SUM, MIN, MAX, AVERAGE, STDDEV, and PERCENT. When a statistical 
function is used to define a computed variable, it can have one or two 
arguments. These arguments are data items. 

If two arguments are used, then the second argument restricts the 
scope of the statistic's computation. For instance, AVERAGE 
(MOSAL,DNUM) is the average of monthly salaries for consecutive report 
details with the same department number. Normally, this function 
would be included in the footer defined for department groups (footers 
are described in the next section) . When a report is generated, each 
group of details for a department number would be followed by a footer 
showing the average monthly salary for the department's employees. If 
this function is included instead in the definition for report 
details, then a department's average will appear in each of the 
details generated for that department group. 

If only one argument is used, the scope of values used in 
computing the statistic depend on whether the computation occurs in a 
report detail, a group footer, a page footer or a report footer. In a 
report detail, the statistic is computed with all values* of the data 
item argument that have been retrieved. In a group (page or report) 
footer, the computation uses only those values* retrieved for that 
group (page or report) . For instance, the value of AVERAGE (MOSAL) in 
a report detail is the average of all monthly salaries for employees 
that appear in the report. In a page footer, it is the average of all 
salaries on the page, and so forth. 


* If no values have been retrieved, each statistic is set to 0. 
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A designer can optionally specify conditions for built-in 
functions. To define a computed variable whose value is the average 
department salary for employees over 30 years of age, the designer 
specifies 


FOR (AGE>30) AVERAGE (MOSAL, DNUM) . 

The report designer can alternatively define computed variables 
in terms of special functions. A special function is created by the 
designer. It is essentially a program module that computes a value. 
Inputs to the function are specified as arguments when the function is 
invoked. Each argument corresponds to a parameter used within the 
function's body. Local working variables can also be declared within 
the function's body. In addition to assignment statements, if-then- 
else and test-case statements can be used within a function. A return 
statement is used to exit from a function with the function's value. 


F. Grouping: Headers and Footers 

The designer can request that report details be grouped in 
various ways. A major aspect of grouping is that a header and a 
footer can be specified to automatically accompany each group of 
report details. A header or footer can be designed to consist of one 
or more lines containing literals and/or data values. The data values 
can be values of data items, prompt variables, or computed variables. 

The header for a group appears immediately before the group's 
report details. Normally, the header is designed to contain 
descriptive information introducing a group of details. A footer for 
a group appears just after the group's details. It is usually 
designed to contain information summarizing a group of details. 

The simplest kind of grouping is to group by report. This causes 
all of a report's details to be treated as a group. The header and 
footer specified for this kind of grouping appear at the start and 
finish of the report, respectively. Report details can also be 
grouped by page. Since each group consists of a page of report 
details, the header and footer specified for page grouping serve as 
page headers and footers, appearing at the start and finish of each 
page. 


Another kind of grouping allows report details to be separated 
into groups based on the values of a specified data item (or computed 
variable) . As the generated program creates each new report detail, a 
check is made to see whether the specified data item (or computed 
variable) value has changed since the last report detail. If it has 
changed, then the newly created report detail begins a new group of 
report details. As with report grouping and page grouping, each 
resulting group can be prefaced by a header and followed by a footer. 

The designer can specify multiple levels of grouping. The 
grouping of one level occurs within each group produced by the next 
higher (i.e., broader) level of grouping. For instance, suppose that 
report details consist of employee information and that three levels 
of grouping have been declared by the designer. At the highest level 
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there is grouping by company, then grouping by division, and finally 
grouping by department. The generated program produces an output 
report having employees grouped by company. within each company 
group, the employee details are grouped by the division in which they 
work. Within each division, employees are grouped by department. 


G. Sorting 

A designer can specify two types of sorting ; sorting of report 
details and sorting of groups. If a designer has requested sorting of 
report details, then the generated program will output report details 
in sorted order. If grouping (other than by report or by page) has 
been requested for the report, then the sorting of report details 
occurs within each of the lowest level groups. When specifying a 
grouping (other than by report or by page) the designer can request a 
sorting of the resultant groups. 

In general sorting can be based on the values of one or more data 
items and/or computed variables. Any mixture of ascending and 
descending directions can be specified. For instance, the sorting of 
employee details (within each division) might be based on ascending 
job codes and descending monthly salary. The sorting of department 
groups (within a division) might be based on ascending department 
code. Within each company, division groups could be ordered by 
ascending division names. Finally, company groups might be arranged 
in terms of descending (i.e., highest to lowest) annual sales. 

H. Relationships 

Just as important as the data items used in generating a report, 
are the relationships among those data items. Because of the inherent 
flexibility of MDBS's postrelational approach to data structuring, a 
schema allows many relationships to exist among a group of selected 
data items. Set names are used to indicate the semantics of various 
relationships. The report designer can choose which relationships are 
to oe used by the generated program in producing its report. 
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A. Notational Conventions 

After the content and layout for a report has been determined, 
the report can be formally specified with the Report Definition 
Language. An RDL source specification consists of several sections. 
Each section consists of various kinds of clauses; some of which are 
optional and some of which are required. These clauses are presented 
on a section-by-section basis. Discussion of those clauses that can 
be regarded as advanced features are denoted in the left margin by a 
vertical bar. The complete syntactic description of all clauses 
appears in Appendix B. Figure III-l shows the meanings of the 
notations used. 

A clause is composed of one or more of the following terms ; 
keywords, identifiers, file names, strings, integers, real numbers, 
formats, user names, passwords, procedures. 

Keywords are denoted by upper case letters. All other terms in a 
clause are in lower case. This upper case vs. lower case distinction 
is for documentation purposes only. Upper and lower case can be mixed 
in an actual RDL source specification. A complete list of RDL 
keywords appears in Appendix A. 

Identifiers used in describing an RDL section are denoted by 
id-1, id-2, id-3, etc. Identifiers are selected by the report 
designer. An identifier consists of from one to eight alphanumeric 
characters. An RDL keyword can be used as an identifier if it is 
immediately preceded by the ITEM keyword. If the ITEM keyword is not 
inserted prior to an identifier, then that identifier should not be an 
RDL keyword. 

Fil e names used in describing an RDL section are denoted by file- 
1, file-2, file-3, etc. File names are chosen by the report designer; 
they must be fully qualified file names within the host operating 
system. 

Integers used in describing an RDL section are denoted by int-1, 
int-2, int-3, etc. 

Real numbe r s used in describing an RDL section are denoted by 
real-1, real-2, real-3, etc. 

Formats are used to control the output appearances of numeric 
expressions. Denoted by fmt, a format is enclosed in a matching pair 
of quotes. Formats are specified in the C languages printf style. 
The manual that accompanies the C compiler should have descriptions of 
permissible printf formats. 

Strings of characters are denoted by string-1, string-2, etc. 
Each string within an RDL section has a unique number as its suffix. 
The actual string values are chosen by the report designer. A string 
value must fit within a pair of matching double quotes on one line of 
the RDL source specification. 
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H-53E jpamas , denoted by usr, are one to sixteen character 

(alphanumeric) names. 

PflS$WQCdS > denoted by pass, are one to twelve character 

(alphanumeric) strings. 

Procedures used in describing an RDL section are denoted by 
procedure-1, procedure-3, etc. A procedure is a program consisting of 
statements of various kinds: assignment, if-then-else, test-case, 

break, and return. 


An underlined expression must appear. 


Zero or one of the alternatives within 
the brackets must be used. 


Exactly one of the alternatives within 
the braces must appear. 


* 

One or more of the alternatives within 
the braces must appear. 


Figure III-l. Notation 


B. RDL Sections 

An RDL source specification consists of up to seven kinds of 
sections. These sections must appear in the order given below. 
Clauses within a section are stated in a free format (i.e., column 
positioning is unimportant for the RDL Analyzer) . Upper case and 

lower case can be used interchangeably. More than one clause can 
appear on a line; a clause (but not a term) can be split over more 
than one line; unless otherwise indicated, optional clauses within a 
section can appear in any order. Clauses are separated by blanks. 
Comments can appear between any two terms of clauses within an RDL 
source specification. 

The kinds of RDL sections and their ordering are as follows: 
dentif ication Section 
Prompt Section (optional) 

Output Control Section (optional) 

Function Definition Section (optional) 

Computed Variable Section (optional) 

Report Detail Section 

Group Section (optional) 
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Comments in an RDL source specification 

The characters /* located anywhere in the RDL 
specification indicates that all text that follows is a 
until the comment is terminated by the characters */ 

Comments can extend over many lines. 

Examples: /* THIS IS A COMMENT */ 

/***** 

* 

* RDL SOURCE SPECIFICATION 

* 

*****/ 

/* 

FUNCTION DEFINITIONS 

*/ 


source 

comment. 
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IDENTIFICATION SECTION 

The identification section must be present. This section is used 
to identify which MDBS data base will be accessed by the generated 
program. This will be referred to as the target data base. Ir. 
addition, the report designer uses this section to specify 

* a user name and password, to confirm that the designer does 
have access to the data base, 

* the names of files that are to hold the generated program. 

The identification section's clauses should be stated in the 
order shown below. 


a) Data base clause DATABASE FILE NAME IS "file-1" 


The indicated file-1 must be the physical file that holds 
the main area of the target data base. The data dictionary in 
this main area is used by the RDL Analyzer during program 
generation. File-1 is a fully qualified file name for the 
host operating system. 


Examples: DATABASE FILE NAME IS "B:DEB" 

DATABASE NAME " INVEN/DBs 1" 

DATABASE " /us r/db/customer .db" 

b) User clause (optional) USER IS WITH 



The indicated usr must be a bona fide user for the target 
data base and pass must be that user's password. If this 
clause is omitted, the designer must specify the user and 
password on the operating system command line when the RDL 
Analyzer is invoked. Such an omission is desirable in 
security-sensitive circumstances, because it means that a 
valid name and password will not appear in the RDL 
specification. If use or pass contains a blank, then quotes 
must be used. If quotes are not used for usr or pass then 
all its alphabetic characters are converted to upper case. 

Examples: USER IS "Alvin Wade" WITH SECRET 

USER GC15 "DJL" 

USER KnowledgeMaster WITH MDBS 
USER deb WITH "mon reve" 
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c) Program clause (optional) PROGRAM FILE IS "f ile-2" 

The RDL Analyzer will generate one or two C source code 
programs, plus two command files. One command file will 
compile the source program(s). The other will execute the 
compiled program(s) . 

The indicated file-2 name can be up to seven characters long 
and can be qualified by a drive/directory. It will be appended 
with 1 (and 2) to yield the name(s) of the file(s) holding the 
generated source program(s) . A .C extension is used for source 
code files. The command file for compilation uses the file-2 
name with a C prefix. The command file that executes has the 
name indicated by file-2. 

If the program clause is omitted, file-2 is assumed to be 
RPG. 

Examples: PROGRAM FILE IS "INV" 

PROGRAM "B: SALES" 
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PROMPT SECTION 


The prompt section is optional. It is used to define the prompts 
which the generated program will present to an end user. Each prompt 
is defined in terms of 


a prompt variable which will hold the end user's response, 

. the type and size of the prompt variable, 

a prompt message which will be presented to the end user, 

. a default value for the prompt variable 

a) Prompt clause PROMPT VARIABLES ARE 

This clause is required if you intend to define prompts. It 
is followed by one or more prompt definition clauses. 

Examples: PROMPT VARIABLES ARE 

PROMPT 


b) Prompt definition clause 

r~ C \ 

UNSIGNED 1 ' 

REAL 
INTEGER 

-< BINARY > in.t-1 


iabl< 


l 


BIN 



— 

r S”| 

CHARACTER 




"strina- 2" 1 I 

CHAR 

> ["strinq- 1" 1 

DEFAULT < 

int -4 f 

STRING 


— 


real -1 1 I 

STR ) 




L J J 


RE£XMAL> int- 2 [ . int- 3 ] 
IDEC J 


TIME 
HATE 


A prompt definition begins wth id-1, which is the name of 
the prompt variable being defined. It cannot be a data 
item. This variable is declared to be one of nine types: 
unsigned, real, integer, binary, character, string, internal 
decimal (idee), time, or date. With the exception of time 
and date variables, a size can be specified. For a time 
prompt variable, the end user will be prompted to enter nine 
characters of the form hhh:mm:ss to indicate hours (hhh) , 
minutes (mm) and seconds (ss) . For a date type, the end 
user is prompted for ten characters of the form mm/dd/yyyy 
to indicate a month (mm) , day (dd) and year (yyyy) . An 
internal decimal size consists of two integers. The first, 
int-2, indicates the number of digits accepted for an idee 
prompt variable. The number of digits to the right of the 
decimal point is optionally specified by int-3. If int-3 is 
omitted, then 0 is assumed. For all other types, int-1 
indicates the number of bytes used to hold the prompt 
variable's value. For a 1 or 2 byte integer, a user will be 
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allowed to enter up to 7 digits (including the sign). Up to 
12 can be entered for larger integers. Up to 25 digits 
(including the sign and decimal point) can be entered for a 
real variable. Minimum and maximum sizes were discussed in 
the preceding chapter. 

If the optional string-1 is specified, it serves as a prompt 
message which is output by the generated program. The end 
user sees this message on the console screen just prior to 
the place where the variable's value is to be entered. 

As another option, a default value can be declared for a 
prompt variable. This value is an integer for unsigned or 
integer types, a real number for idee or real types, and a 
string for any of the other type. If a default value has 
been declared for a prompt variable, then that value is 
displayed in square brackets next to the prompt message (if 
any). An end user who desires the default value, needs only 
to press the Return (Enter) key when prompted for a value. 

UFILE, UNAME and UWORD are three special prompt variables. 
If these are defined in the prompt section, they must appear 
in the above sequence and must precede the definitions of 
any other prompt variables. Types and sizes are not 
specified for these special prompt variables. The values 
that an end user supplies for these prompts are immediately 
used by the generated program to attempt to open the data 
base. If the end user has responded with valid values, then 
the data base is opened with the read/write access codes 
assigned to the indicated user name. The rest of the 
prompts are then presented. If an end user has responded 
with invalid values, then execution of the generated program 
is aborted. 

Omission of these three special prompt variables from the 
RDL specification means that the file, user name, and 
password specified by the designer (for RDL analysis) appear 
in the source code of the generated program. As a result, 
the generated program opens the data base with the designer- 
specified file, user name, and password. The end user 
therefore has the read/write access privileges associated 
with the designer-specified user name. 

UDATE, UPAGE and UTIME are also special prompt variables. 
Types and sizes are not specified when these prompt 
variables are declared. The value that an end user supplies 
for UDATE is used as the date that automatically appears at 
the top of each report page. If UDATE is not declared as a 
prompt variable, then the generated program obtains the date 
from the machine clock. The value that an end user supplies 
for UPAGE is the page number that automatically appears at 
the top of the report's first page. If UPAGE is not 
declared as a prompt variable, then 1 is the number of the 
report's first page. The value that an end user supplies 
for UTIME is used to "time-stamp" the report if UTIME is 
specified in the PLACE clause for a detail, header or 
footer . 
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Examples: 

UNAME "USER NAME:" 

BDATE DATE "BEGINNING DATE: " 

EDATE DATE "ENDING DATE: " 

MAX SAL IDEC 8,2 "MAXIMUM SALARY OF INTEREST IS " 

DNAME CHAR 12 "DEPARTMENT NAME?" 

CCAP REAL 4 "Estimated cost of capital: " 

UCOM STR 75 

"Enter comments to be included on each report page:" 
CDATE DATE "TODAY'S DATE " 

CTIME TIME "CURRENT TIME =" 

ODEV CHAR 7 "OUTPUT DEVICE (S or P)?" DEFAULT "PRINTER" 
PSIZ INT 1 "How many lines per page?" DEFAULT 55 
UPAGE "Starting page?" DEFAULT 5 
UTIME "What time is it?" 
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OUTPUT CONTROL SECTION 


The output control section is used to govern the general 
appearance of reports produced by the generated program. In this 
section a report's page size, left margin width, and top margin depth 
can be specified. The automatic date and page numering for each page 
can be suppressed. There are also clauses to indicate output pauses 
and the device (printer, screen, disk file) to which output from the 
generated program is to be sent. The output control section and any 
of the six clauses in this section are optional. The clauses in this 
section can be specified in any order. 


a) Page size clause (optional) 


EA&E. SIZE 


lines 

i.d-1, f 


This clause is used to specify the maximum number of lines 
that will appear on each page of the report. If int-1 is 
specified, then that integer is "hard-wired" into the 
generated program. Alternatively, a previously defined 
prompt variable, id-1, can be specified. This allows an end 
user of the generated program to alter the page size as 
desired, via a response to the id-1 prompt. If the optional 
page size clause is omitted, a default of 24 lines per page 
is used. 

If the identification section's screen clause is present, 
then the page size clause has no effect. 

Examples: PAGE SIZE IS 20 

PAGE 55 LINES 
PAGE PSIZ 

b) Left Margin clause (optional) LEFT MARGIN 



This clause is used to specify the location of the left 
margin for report pages. The number of spaces to the left 
of this margin is indicated either by int-2 (an integer) or 
by a previously defined prompt variable (id-2). The 
placements of report details within a page are made relative 
to the left margin. If the optional left margin clause is 
omitted, a left margin of five spaces is used. 

When windows or screens are placed on a page, the left 
margin is ignored. 

Examples: LEFT MARGIN 2 

LEFT 8 

LEFT LPROMPT 
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c) Top margin clause (optional) 


TOP MARGIN 



The top margin clause is used to specify the location of the 
top margin for report pages. The number of blank lines 
above this margin is indicated either by int-3 (an integer) 
or by a previously defined prompt variable (id-3). The 
placement of lines within a page is made relative to the top 
margin. Omission of this optional clause results in a top 
margin of two blank lines. 


d) 


Examples: TOP MARGIN 0 

TOP 4 

TOP TPROMPT 


Device clause (optional) 


DEVICE 


PRINTER 
SCREEN 
i "file-1" 
id-5 


> 


Reports can be routed to a console screen, printer, or disk 
file. If PRINTER, SCREEN, or file-1 is specified, then that 
choice is hardwired into the generated program. 
Alternatively, a previously defined prompt variable (id-5) 
having an STR type can be specified (the variable's size is 
automatically set to be 10). This enables an end-user to 
choose one or more devices for each run of the generated 
program. The end user must respond to the prompt by 
entering some combination of the letters S, P, F. If 
printer output is desired, a P must be entered. A response 
of S causes output to be routed to the console screen. 
For disk file output, the end user's response must have an 
F. This causes the end user to be prompted for a fully 
qualified file name. If the device clause is not present, 
SCREEN is assumed. 


Examples: DEVICE PRINTER 

DEVICE "B: REPT .T" 

DEVICE D EVP ROM 

e) pause clause (optional) PAUSE AFTER PAGE 

If this optional clause is present, output from the 
generated program win pause after each page. The page 
depth is controlled by the page depth clause. This pause 
occurs only for screen and printer output devices. Output 
resumes when the end user presses the Return (Enter) key. 

Examples: PAUSE 

PAUSE AFTER PAGE 
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f) Date/page suppression clause (optional) SUPPRESS DATE PAGE 


The generated program will automatically output a date and 
page number on the top line of each report page, with the 
exception of the report header pages (if any). Either or 
both of these can be suppressed with the date/page 
suppression clause. If neither DATE nor PAGE is specified 
in this clause, both are suppressed. If the identification 
section contains a screen clause, then both date and page 
number are automatically suppressed. 


g> 


Examples: SUPPRESS PAGE 

SUPPRESS DATE 
SUPPRESS DATE PAGE 
SUPPRESS 

Form alignment clause (optional) 


ALIGNMENT 



This clause causes the generated program to print out a 
specified number of empty pages, for purposes of aligning 
preprinted forms (using the printer line feed control). The 
number of pages can be stated explicitly (int-4) by the 
report designer. Alternatively, the designer can indicate 
that the value of the id-6 prompt variable is to be used to 
control the number of alignment pages. 


Examples: ALIGNMENT PAGES 3 

ALIGNMENT 1 
ALIGNMENT ALPGS 
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FUNCTION DEFINITION SECTION 

The function definition section is optional. If it is present in 
an RDL specification, it consists of one or more function definitions. 
Any of the functions defined in this section can later be used when 
defining computed variables in the next section. Each function is 
defined in terms of three clauses: function identification, parameter 

typing, and function computation. These clauses must appear in the 
order shown here. 

a) Function identification clause 

EHBCIIQH id=l [lUd=2,}*ll typfirl 

In this clause a function is given a name (id-1) , a type and 
a size. Because a function has a numeric value, type-1 must 
be INT, REAL, IDEC or UNSIGNED. With the exception of IDEC, 
the associated size-1 is an integer indicating how may bytes 
of storage are used to hold the function's value. For IDEC, 
size-1 is an integer indicating how may digits are in the 
function's value. Optionally, a second integer can be 
specified for the idee type to declare the number of digits 
to the right of the decimal point (if this is omitted, 0 is 
assumed) . 

If desired, a function can be declared to have one or more 
parameters. The names (e.g., id-2) of these formal 

parameters are separated by commas and enclosed within a 
pair of parentheses. A comma should not be used following 
the last parameter. 

Examples: FUNCTION COMPUTAX (Pi) REAL 4 

FUNCTION RTRNRATE (Xl , X2 , X3 , X4 , X5 , I ) IDEC 9,7 
FUNCTION DATECVRT INT 4 
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b) Parameter typing clause 


r 




I iia=2,}* l 




< 


UNSIGNED 

BEAL 

iniegeb 

INI 

BINABI 

BIN 

CHARACTER 

CBAB 


SIRING 
V. SIB 




> Intml 


J 


^ * 




> 


V 


DECIMAL 

IDEC 

TIME 

DATE 


inim2 1 , int-3] 


V J J 

A type and size must be specified for each of the parameters 
declared in the function identification clause. The nine 
permissible types are unsigned, real, integer, binary, 
character, string, idee, time and date. No size is 
specified for time and date parameters. An idee parameter 
size can be specified in terms of two integers: int-2 is 

the total number of digits and int-3 is the number of digits 
to the right of the decimal point. If int-3 is omitted, its 
value is assumed to be 0. For all other types, int-1 
indicates the number of bytes used to hold the parameter's 
value. Minimum and maximum sizes were discussed in the 
preceding chapter. 


Examples: PI IDEC 4,1 

I REAL 4 Xl,X2,X3,X4 IDEC 7,2 X5 IDEC 10,2 

PCODE CHAR 8 

c) Function computation clause I pr ocedure-1 1 

This clause consists of a procedure enclosed in a matching 
pair of braces. The procedure is composed of local variable 
declarations followed by a sequence of statements. A local 
variable is used only within the procedure in which it is 
declared. Local variables for a procedure are not 
mandatory, but can be useful for holding temporary results. 
A local variable is declared in exactly the same manner as a 
parameter (see the parameter typing clause above) . 

After a procedure's local variables have been declared, a 
sequence of statements is specified which indicates how to 
compute the function's value. Five kinds of statements are 
allowed: assignment, if -then-else, test-case, break, and 

return. Any of these kinds of statements can be nested 
within an if-then-else or test-case statement. A return 
statement must be present. If the procedure execution does 
not exit through a return statement, then the function's 
value is undefined. Each statement within a procedure is 
terminated by a semi-colon (;). 
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i) Assignment statement 

An assignment statement has the form: 

variable = axpiaasiartzLi 

where the variable is a local variable which has been 
declared earlier in the procedure and the expression is 
an arithmetic expression. The permissible arithmetic 
operators in an expression are +, - , * , /, % (modulo), 
and unary-. The permissible operands are numbers, 
prompt variables, local variables, data items, 
parameters, and parenthesized arithmetic expressions. 
When an expression is evaluated, the following operator 
precedence is observed within each matching pair of 
parentheses (if any): 

unary-, *, /, %, +, - 

Expressions in the innermost parentheses pairs are 
evaluated first. 

Examples : 

TEM4=3+P1 ; 

VAR=PROMPT3/32+MOSAL; 

TAX=BASE+ (YRSAL-BASE) *PRCNT ; 
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ii) If-then-else statement 

An if-then-else statement has the form: 

IE TEEN i siaLsmfiJXfcsr.1 1 ELSE i stflt£iBents=2 1 

If the specified condition is met, then the statements 
of statements-1 are executed. In cases where ELSE is 
used, the statements of statements-2 are executed when 
the specified condition is not satisfied. 

A condition is enclosed within a matching pair of 
parentheses. It is composed of one or more relational 
expressions, each of which evaluates to true or false. 
Any one of the following relational operators can be 
used in a relational expression: 

=, <>, > = , < = , >, < 

Operands in a relational expression can be numeric or 
character constants, prompt variables, local variables, 
parameters, data items, or arithmetic expressions. 

Wildcard string and symbol match characters (* and $, 
respectively) are allowed in character constants. 
Where a * appears within a quoted character constant, 
any string of zero, one or more symbols will match the 
*. Where a $ appears in a quoted sequence of 
characters, any single symbol will match it. In 
addition, a character class can be specified within a 
character constant by enclosing a group of characters 
within square brackets [3. The character class 
position in the constant is matched by any of the 
characters in the group. For example, "L[e,o3t" 
matches Let or Lot; "[A-M3* n matches any character 
sequence beginning with A, B, ..., or M; "$[a-c,p3" 
matches any two characters having a, b, c, or p as the 
second character. 

There is one additional operator beyond those noted 
above: the IN operator. The operand following IN 
consists of one or more constants enclosed in a 
matching pair of square brackets. The IN expression 
evaluates to true if the value of the left operand is 
equal to one of the constants of the right operand. 
Thus DEPT IN [5,7,13,23 is true if the value of DEPT is 
5, 7, 12, or 2. NAME IN [ "A* ", "*E " , "*S [ 0, E 3 N" 3 is true 
if the value of NAME begins with A or ends with E, SON 
or SEN. 

Within condition-1, logical operators can be applied to 
relational expressions. When condition-1 is evaluated, 
the following precedence of logical operators is 
observed: 

NOT, AND, OR, XOR 
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Parentheses can be used to control the order of 
evaluation within the condition. The contents of 
innermost parentheses are evaluated first. 

Statements within an if-then-else statement can be any 
of the five kinds of statements permitted in a function 
computation clause. However, a break statement can be 
used only if the if-then-else statement is nested 
within a test-case statement. 

Examples : 

IF (PCODE=125A34 ) THEN {TEMP=P2+12J ELSE {TEMP=P2>; 

IF (P12>=PROMPT3 AND P7<13) THEN {TEMP7=TEMP7+1 ;T12=T12-PROMPT3 } ; 
IF (MOSALClOOO) THEN (IF(P4>1.2) THEN {TEMP=MOSAL/500 > 

ELSE {TEMP=MOSAL/400> } ELSE {TEMP=MOSAL } ; 

IF (PCODE=125 $34 ) THEN {TEMP=P2+12> ELSE (TEMP=P2>; 


iii) Test-case statement 

A test-case statement has the form: 

TEST (.expression ^ {(CASE constant-1 : statements-3 : } * (OTHERWISE: Statementa-H } 

As soon as a case constant which equals the test 
expression's value is detected, the statements for that 
case and statements of all subsequent cases (including 
the default case) are executed. However, if one of 
these is a break statement (described below), then the 
remaining statements within this test-case statement 
are skipped. 

The test expression can be a prompt variable, local 
variable, data item, parameter, or arithmetic 
expression. It is enclosed in a matching pair of 
parentheses. Following expression-2, is a sequence of 
cases enclosed in a matching pair of braces. Each case 
is specified in terms of a constant, which is compared 
to the value of expression-2 when the test-case 
statement is evaluated. Following the case constant is 
a sequence of one or more statements. These statements 
(and those of subsequent cases) are executed for the 
first case constant which satisfies the test 
expression. The statements associated with a case can 
be any of the five kinds of statements permitted in a 
function computation clause. A default case, denoted 
by OTHERWISE, can optionally be specified. If it is 
included, then statements-4 are executed even though 
none of the case constants preceding it satisfy the 
test expression. 

Example : 

TEST (PI) {CASE 0: RAISE=YTDEARN*. 05 ;BREAK ; 

CASE 1: RAISE=YTDEARN*.l; BREAK; 

OTHERWISE: RAISE=0) 
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iv) Break statement 

A break statement has the form: 

BREAK ; 

When a break statement is encountered in statements-3 
or statements-4 , execution immediately breaks away to 
the statement following the end of the (innermost) 
test-case statement containing the break. 

Example: BREAK; 


v) Return statement 

A return statement has the form: 

RETURN (express ion- 3) 

When a return statement is encountered in the course of 
executing a function's procedure, execution of the 
procedure halts and the value of expression-3 is 
returned as the function' s value. The expression 
should have a numeric value: being a numeric constant, 

data item, parameter, local variable, prompt variable, 
or an arithmetic expression involving any of these. 

Examples: RETURN ( 5) ; 

RETURN (PCODE) ; 

RETURN ( (MOSAL/IOOO) *1.03) ; 
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COMPUTED VARIABLE SECTION 


This optional section is used to define one or more computed 
variables. Each such variable is given a name, type, size. in 
addition, there is a declaration of how the variable's value is to be 
computed. This computation is stated in terms of a function defined 
in the previous section or a built-in statistical function. 


a) Computed variable clause COMPUTED VARIABLES ARE 

If a computed variable section exists, this must be its 
first clause. It can be followed by one or more computation 
clauses. 

Examples: COMPUTED VARIABLES ARE 

COMPUTED 


b) Computation clause 


id rr l .t y .p.fi-1 size-1 i 


< 


[IfiR (condition-1)^ < 


'SUM 

A V S RAGJ2 

MAX 

MIN 

£QHHZ 

STDDEV 

PERCENT . 


•\ 


> (arguments-1) 


> 


^function-! [ (arouments-2) 3 J 

In this clause a computed variable is given a name (id-1) , a 
type and a size. It cannot have the same name as a data 
item. If a computed variable has a numeric value, then 
type-1 must be INT, REAL, IDEC or UNSIGNED. If a computed 
variable has a non-numeric value, then type-1 must be CHAR. 
With the exception of IDEC, the associated size-1 is an 
integer indicating how may bytes of storage are used to hold 
the computed variable's value. For IDEC, size-1 is an 
integer indicating how may digits are in the computed 
variable's value. Optionally, a second integer can be 
specified for the idee type to declare the number of digits 
to the right of the decimal point (if this is omitted, 0 is 
assumed) . 


The nature of the computation used to determine the computed 
variable's value is indicated by a function and its 
arguments (if any) . The function is either a built-in 
Statistical function (COUNT, SUM, MIN, MAX, AVERAGE, STDDEV, 
PERCENT) or a function (function-1) defined in the previous 
section of the RDL specification. If function-1 was defined 
with parameters, then one argument must be specified for 
each parameter. Prompt variables, previously declared 
computed variables, data items, and numeric constants can be 
used in the argument list (arguments-1, arguments-2) . The 
arguments in argument-1 or arguments-2 are separated by 
commas and surrounded by a matching pair of parentheses. 
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The optional FOR clause can be used to specify conditions on 
a computation involving a built-in statistical function. A 
condition is enclosed within a matching pair of parentheses. 
It is composed of one or more relational expressions, each 
of which evaluates to true or false. Any one of the 
following relational operators can be used in a relational 
expression: 

=, <>, >=, <=, >, < 

Operands in a relational expression can be numeric or 
character constants, prompt variables, local variables, 
parameters, data items, or arithmetic expressions that do 
not involve functions defined in the RDL functionn 
definition section. 

Wildcard string and symbol match characters (* and $, 
respectively) are allowed in character constants. Where a * 
appears within a quoted character constant, any string of 
zero, one or more symbols will match the *. Where a $ 
appears in a quoted sequence of characters, any single 
symbol will match it. In addition, a character class can be 
specified* within a character constant by enclosing a group 
of characters within square brackets []. The character 
class position in the constant is matched by any of the 
characters in the group. For example, "LCe,olt" matches 
Let or Lot; "[A-M]*" matches any character sequence 
beginning with A, B, ..., or M; "$[a-c,p] n matches any two 
characters having a, b, c, or p as the second character. 

There is one additional operator beyond those noted above: 
the IN operator. The operand following IN consists of one 
or more constants enclosed in a matching pair of square 
brackets. The IN expression evaluates to true if the value 
of the left operand is equal to one of the constants of the 
right operand. Thus DEPT IN [5,7,13,2] is true if the value 
of DEPT is 5, 7, 12, or 2. NAME IN [ « a*" , »* e" , " * S [ 0 , E ] N" 1 
is true if the value of NAME begins with A or ends with E, 
SON or SEN. 

Within condition-1, logical operators can be applied to 
relational expressions. When condition-1 is evaluated, the 
following precedence of logical operators is observed: 

NOT, AND, OR, XOR 

Parentheses can be used to control the order of evaluation 
within the condition. The contents of innermost parentheses 
are evaluated first. The condition-1 and arguments-1 
specifications together can contain references to as many as 
10 variables. 

Examples: 

EMPCNT I NT 2 {FOR (YTDEARN >13000.0) COUNT (LASTNAME) } 

EMPCNT INT 2 {FOR (DEPNO IN [13,2,9]) COUNT (LASTNAME)} 

TAX IDEC 3,2 {COMPUTAX (YRLSAL) } 

IRR IDEC 5,3 {RTRNRATE (200,2200,2400,2600,28000,20000)} 

JDATE INT 4 {DATECVRT ( ) } 
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REPORT DETAIL SECTION 

This section is used to specify the detailed contents of the 
report. It consists of five kinds of clauses which must appear in the 
order shown below. These clauses are used to indicate 

* where to position output lines on a report page 

* the conditions under which data is to be retrieved (and thus 
displayed) from the data base 

* the relationships that are to be used in retrieving data from 
the data base 

* the sorting that is to be performed for retrieved data 
This section cannot be omitted from an RDL specification. 

a) Report clause report 


The report detail section must begin with the word REPORT. 
This is followed by one or more place clauses. 

Example: REPORT 

b) Place clause 


PLACE ( [ UNIQUE! 


1-1 [ FORMAT "fmt"1 re int-1] > 1 


SKTP H 


[LINES BEFORE [ int-3 LINES AFTER] ]' 
LINES AFTER 


Many place clauses can be specified. Each place clause 
defines a line of output. One or more expressions can be 
assigned to an output line. Expression-1 is a numeric 
constant, a string of characters enclosed in double quotes, 
a prompt variable, a computed variable, a data item, or an 
arithmetic expression. When a data item is involved in an 
expression, it can be prefaced by its record type name and a 
period (.). Multiple data items of the same name may exist 
in the record types involved in relationships specified in 
the relationship clause (described below). in this case, 
the record type name must be used to preface these data 
items . 


The value of expression-1 is formatted according to the 
indicated fmt and placed int-1 spaces from the report page's 
left margin. The int-1 that is specified must be in the 
range from 0 through 252. Optionally, int-2 lines can be 
skipped before the output line and/or int-3 lines can be 
skipped after the output line. If neither BEFORE nor AFTER 
is specified, BEFORE is assumed. Thus, an int-2 of 1 
results in single spacing, an int-2 of 2 produces double 
spacing, and so forth. If this option is omitted, single 
spacing is assumed. 
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If the FORMAT option is omitted, a default format will be 
used. All default formats left justify expression values. 
The default format that is used for an expression depends on 
the type and size of its values. It also depends on how 
many positions are available for displaying its value 
(before the next expression's starting point on the line). 
In the following chart this number of positions is indicated 
by x. 


TvDe 

Size 

Pefaul.t__F9Ema-t. 

UNSIGNED 

1 or 2 

"%-xu" 

UNSIGNED 

3 or 4 

"%-xlu" 

REAL 

any 

"%-x.Of" 

INTEGER 

1 or 2 

"%-xd" 

INTEGER 

3 or 4 

"%-xld" 

BINARY 

any 

"%-xo" 

CHARACTER 

y characters 

"%-x. ys" 

STRING 

any 

"%-x. xs" 

IDEC 

ZtY 

"%-x.yf " 

TIME 

— 

"%-x. 9s" 

DATE 

— 

"%-x. 10s" 

proper integer values for x 

and y are automatically 


determined, depending on value length and/or defined sizes 
of the expression's variables. Examples are shown in the 
generated programs that appear in Chapter VI. 

There are two further options. Each expression in the place 
clause can be qualified by UNIQUE and/or UNDERLINED. The 
UNIQUE qualifier causes successive duplicate values of the 
expression to be suppressed in the output report. For 
instance, if five successive report details have the same 
expression value, then that value will be displayed only in 
the first of these details. The UNDERLINED qualifier causes 
values of an expression to be underlined in the output 
report. 

Examples ? PLACE "NAME" § 2 "ADDRESS” @ 20 
PLACE JDATE @30 SKIP 2 
PLACE FNAME @12 

UNIQUE LNAME @ 23 
"AGE" @ 40 

AGE @44 SKIP 4 AFTER 

PLACE UNDERLINED MOSAL @ 18 YRLSAL @28 TAX @38 
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Special Case: Placing a Repeating Data Item 

A repeating data item can have multiple values. Using the 
above form of the place clause, will cause these values to 
be placed one beneath the other in a column indicated by 
int-1. This column of values begins after int-2 lines are 
skipped and is followed by skipping int-3 lines. If UNIQUE 
is specified, only the first value of a succession of two or 
more duplicate values is output. 

Greater control over the placement of a repeating data 
item's values is provided by an alternative form of the 
place clause. For a repeating data item, 

§ int-1 

in the place clause syntax can be replaced by 

ill-t-4 ACROSS [ FROM ( in.t-5 , int-6) 3 @ int-7 [ { , int-8 >* ] 

RQm (ZRQM l .int r AjtJjl. t r LQ 2 J 1 int -11 

Here, int-4 is a positive integer indicating how many of the 
repeating data item's values are to be placed on each line. 
For example, if there are 14 values and 5 ACROSS is 
specified, then the values are placed on three consecutive 
lines (with only four values on the third line) . The first 
value on each line begins in the column indicated by int-7, 
the second in the column indicated by int-9, and so forth. 
Columns must be in the range from 0 through 252. If fewer 
than int-4 column starting positions are specified, the 
remaining columns are automatically positioned so that an 
inter-column spacing of 2 results. If more than int-4 
starting positions are specified, then an error message 
results. 

Regardless of whether DOWN or ACROSS is specified, the 
report designer can optionally request that only some of the 
repeating values be output. This is accomplished by stating 
which value to begin with (as indicated by int-5 or int-9) 
and which value to end with (as indicated by int-6 or 
int-10) . For instance, FROM (9,14) means that the ninth 
through fourteenth values of the repeating data item will be 
output. If int-6 (for ACROSS) or int-10 (for DOWN) exceeds 
the maximum replications of a repeating data item, then the 
maximum is used. 

Examples: 

PLACE PASTJOBS 3 ACROSS @ 5,25,43 
PLACE LINE 2 ACROSS FROM (1,4) @ 2,52 
PLACE LINE DOWN FROM (3,5) @ 12 
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c) Conditional clause (optional) 

££R (con d i t ion- 11 

The conditional clause is optional. It states the 
conditions that must be met by the data items included in 
place clauses and mapped to frames of windows (and screens) 
included in display clauses. A report detail (as specified 
by the place and for display clauses) is generated only for 
data values that satisfy condition-1. 

A condition is enclosed within a matching pair of 
parentheses. It is composed of one or more relational 
expressions, each of which evaluates to true or false. Any 
one of the following relational operators can be used in a 
relational expression: 

=, <>, >=, <=, >, < 

Operands in a relational expression can be numeric or 
character constants, prompt variables, local variables, 
parameters, data items, or arithmetic expressions that do 
not involve functions defined in the RDL function definition 
section. 

Wildcard string and symbol match characters (* and $, 
respectively) are allowed in character constants. Where a * 
appears within a quoted character constant, any string of 
zero, one or more symbols will match the *. Where a $ 
appears in a quoted sequence of characters, any single 
symbol will match it. In addition, a character class can be 
specified within a character constant by enclosing a group 
of characters within square brackets []. The character 
class position in the constant is matched by any of the 
characters in the group. For example, "L[e,o]t" matches 
Let or Lot; "[A-M]*" matches any character sequence 
beginning with A, B, . .., or M; "$[a-c,p] n matches any two 
characters having a, b, c, or p as the second character. 

There is one additional operator beyond those noted above: 
the IN operator. The operand following IN consists of one 
or more constants enclosed in a matching pair of square 
brackets. The IN expression evaluates to true if the value 
of the left operand is equal to one of the constants of the 
right operand. Thus DEPT IN [5,7,13,2] is true if the value 
of DEPT is 5, 7, 12, or 2. NAME IN [ "A* " , " *E" , " *S [0, E] N" ] 
is true if the value of NAME begins with A or ends with E, 
SON or SEN. 

Within condition-1, logical operators can be applied to 
relational expressions. When condition-1 is evaluated, the 
following precedence of logical operators is observed: 

NOT, AND, OR, XOR 
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Parentheses can be used to control the order of evaluation 
within the condition. The contents of innermost parentheses 
are evaluated first. 


Examples : 

FOR (MOSAL > 1000) 

FOR (AGE < 32 AND MOSAL < 2000) 

FOR (DNUMBER IN [12,5,18,20] AND ADDRESS = " *CHICAGO* " ) 


d) 


Relationship clause 


2HBII 


[-] [> 1 set 




* 


The relationship clause is required. It enables the report 
designer to concisely specify the data interrelationships 
that should exist among data values in the desired report. 
Two RDL specifications that differ only in their 
relationship clauses will typically yield different reports. 
To use the relationship clause, examine all data items 
included in the RDL specification. In the schema, place a 
check mark on every record type that contains at least one 
of these data items. In order to produce the report, the 
generated program will have to examine occurrences of each 
of the checked record types. Thus the relationship clause 
should specify a sequence of sets, indicating which 
relationships among checked record types are to be used by 
the generated program. 


The RDL Analyzer can generate a program capable of 

processing either upstream (member to owner) or downstream 
(owner to member) through a set. If the sequence of 
relationships requires an upstream movement for some set, 
then that set's name is prefaced with the > symbol. If 

report details are specified in terms of a computed variable 
involving a built-in function, then the second argument (if 
any) of that function should not be a data item reached via 
an upstream relationship through a 1:1 or 1:N set. 

The sequence of relationships in this clause must begin with 
a SYSTEM-owned set and must connect all checked record 
types. A relationship loop is not allowed; that is, the 
sequence of sets must not enter the same record type more 
than once. Placing a negative sign (-) in front of a set 
causes the generated program to examine the set's member (or 
owner, for upstream processing) occurrences in reverse 
order . 

Examples : 

THRU IDEP, HAS, POSSESS 

THRU IDEP, HAS, >FILLEDBY, NEEDS 

THRU IDEP, -HAS, ->FILLEDBY, NEEDS 
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e) 


Sort clause (optional) 


SORT BY 


r 

— — 



ASCENDING 



AZl 

> 


DESCENDING 


V 

ZA 

- 


★ 


This optional clause is used to enforce a desired sorting of 
the report details. The sorting can be based on one or more 
data items and/or computed variables. Any mixture of 
ascending (AZ) and descending (ZA) directions can be 
specified. If no direction is stated, then ascending is 
assumed. Omission of the sort clause means that the order 
of report details is determined by the set orders of those 
sets included in the relationship clause. 


Examples: 


SORT BY LASTNAME 

SORT ASCENDING ID DESCENDING MOSAL 

SORT AZ ID ZA MOSAL 

SORT ZA MOSAL AZ LASTNAME ID 
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GROUP SECTION 

The group section is optional. If it is omitted, report details 
appear one after another with no interruption other than page breaks 
forced by the page depth. The group section can be used to specify 
more elaborate structuring of report details within the report. This 
includes 

9 

automatic page breaks based on changes in data item values 
. grouping of report details based on data item values 
. specification of group headers and footers 
. sorting of groups 

Nested groupings are supported. 

a) Page break clause (optional) PAGE BREAK AT id-1 

If this optional clause is present, it must be the first 
clause of the group section. The generated program will 
force a page break to occur whenever the value of id-1 
changes; id-1 is a data item. Page breaks are also caused 
whenever the maximum report page depth is reached. 
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b) Group clause (optional) 


f RE PORT"! 
GROUP BY < PAGE }> 

J 


One or more group clauses can be specified. A group clause 
specifies how report details are to be grouped. There are 
three kinds of grouping: by report, by page, and by id-2 (a 
data item) . REPORT means that all report details are 

considered to constitute a group. PAGE means that all 
report details which fit on a report page constitute a 
group. If id-2 is specified, then grouping is based on the 
value of id-2. All report details with the same value for 

id-2 are in the same group. 

Each group clause can optionally be followed by a header 
clause and a footer clause (in that order). The header 
clause is used to specify header information that will 
precede each group of report details. Similarly, a footer 
clause specifies footer information that will appear after 
each group of report details. For grouping by id-2, a sort 
clause can be specified after the footer to indicate how the 
groups themselves are to be sorted. 

If more than one group clause appears in an RDL 
specification, then multi-level grouping is used. Each 
group clause (other than the first) specifies the grouping 
of report details within groups defined by the preceding 
group clause. For instance, the first group clause may 
specify grouping by company. If the second specifies 
grouping by division, then report details within each 
company group are grouped by division. If a third level 
involes grouping by department, then report details within 
each division are grouped by department. Page grouping 
should not be used more than once in an RDL specification. 
If report grouping is specified, it must be the first group 
clause. If page grouping is specified, its group clause 
must precede all group clauses other than report grouping. 

Examples: 

GROUP BY REPORT 
GROUP PAGE 
GROUP COMPANY 
GROUP BY DIVISION 

c) Header clause (optional) 

HEADER IS 

If a header clause is specified for a grouping, then it must 
immediately follow the .group clause and it must be 

immediately followed by one or more place clauses. The 

place information forms the header for each group of report 
details. 
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Place clause: 


EL ACE ( expression-l [ FORMAT I int-1 )* 




t 


Ant -2 [LINES BEFORE [ int-3 LINES AFTER ] 3 
int-3 LINES AFTER 



Many place clauses can be specified. Each place clause 
defined a line of output. One or more expressions can be 
assigned to an output line. Expression-1 is anumeric 
constant, a string of characters enclosed in double quotes, 
a prompt variable, a computed variable, a data item, or an 
arithmetic expression. The value of expression-1 is 
formatted according to fmt and is placed int-1 spaces from 
the report page's left margin. The value of int-1 must be 
in the range from 0 through 252. 


If the FORMAT option is omitted, a default format will be 
used. All default formats left justify expression values. 
The default format that is used for an expression depends on 
the type and size of its values. It also depends on how 
many positions are available for displaying its value 
(before the next expression's starting point on the line). 
In the following chart this number of positions is indicated 
by x . 


Type 

Size 


Default 

UNSIGNED 

1 or 

2 

"%-xu" 

UNSIGNED 

3 or 

4 

"%-xlu" 

REAL 

any 


"%-x.0f" 

INTEGER 

1 or 

2 

"%-xd" 

INTEGER 

3 or 

4 

" %-xld" 

BINARY 

any 


"%-xo" 

CHARACTER 

y characters 

"%-x .ys" 

STRING 

any 


" % — X • x s " 

IDEC 

Z/Y 


"%-x .yf " 

TIME 

— — 


"%-x . 9s" 

DATE 

— - 


"%-x. 10s 


The proper integer values for x and y are automatically 
determined, depending on value length and/or defined sizes 
of the expression's variables. Examples are shown in the 
generated programs that appear in Chapter VI. 


Optionally, int-2 lines can be skipped before the output 
line and/or int-3 lines can be skipped after the output 
line. If neither BEFORE nor AFTER is specified, BEFORE is 
assumed. Thus, an int-2 of 1 results in single spacing, an 
int-2 of 2 produces double spacing, and so forth. If this 
option is omitted, single spacing is assumed. 

Examples: PLACE "NAME" @ 2 "ADDRESS" @ 20 

PLACE JDATE @30 SKIP 2 
PLACE F NAME @12 
LNAME @ 23 
"AGE" @ 40 

AGE @ 44 SKIP 4 AFTER 
PLACE MOSAL @18 YRLSAL @28 TAX @38 
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Special Case: Placing a Repeating Data Item 

A repeating data item can have multiple values. Using the 
above form of the place clause, will cause these values to 
be placed one beneath the other in a column indicated by 
int-1. This column of values begins after int-2 lines are 
skipped and is followed by skipping int-3 lines. If UNIQUE 
is specified, only the first value of a succession of two or 
more duplicate values is output. 

Greater control over the placement of a repeating data 
item's values is provided by an alternative form of the 
place clause. For a repeating data item, 

0 int-1 

in the place clause syntax can be replaced by 

fint-A ACROSS [ FROM (int-5 , in.t-6) 3 0 int-,7 I ( t > * J ~ 

[DOWN [£RQM Iintr. 9 .,.infc-1Q) I 1 

Here, int-4 is a positive integer indicating how many of the 
repeating data item's values are to be placed on each line. 
For example, if there are 14 values and 5 ACROSS is 
specified, then the values are placed on three consecutive 
lines (with only four values on the third line) . The first 
value on each line begins in the column indicated by int-7, 
the second in the column indicated by int-9, and so forth. 
Columns must be in the range from 0 through 252. If fewer 
than int-4 column starting positions are specified, the 
remaining columns are automatically positioned so that an 
inter-column spacing of 2 results. If more than int-4 
starting positions are specified, then an error message 
results. 

Regardless of whether DOWN or ACROSS is specified, the 
report designer can optionally request that only some of the 
repeating values be output. This is accomplished by stating 
which value to begin with (as indicated by int-5 or int-9) 
and which value to end with (as indicated by int-6 or 
int-10) . For instance, FROM (9,14) means that the ninth 
through fourteenth values of the repeating data item will be 
output. If int-6 (for ACROSS) or int-10 (for DOWN) exceeds 
the maximum replications of a repeating data item, then the 
maximum is used. 

Examples: 

PLACE PASTJOBS 3 ACROSS 0 5,25,43 
PLACE LINE 2 ACROSS FROM (1,4) 0 2,52 
PLACE LINE DOWN FROM (3,5) 0 12 


(C) COPYRIGHT 1983 Micro Data Base Systems, Inc. 


Rev. 85A 37 



MDBS RDL MANUAL 


III. MDBS. RDL SPECIFICATIONS - 


MDBS RDL MANUAL 


u) Footer clause (optional) 

FOOTER IS 

If a footer clause is specified for a grouping, then it must 
immediately follow the place clauses for the header (if a 
header clause exists for the group). A footer clause is 
immediately followed by one or more place clauses. The 
place information forms the footer for each group of report 
details. 

Place clause: 

ELACE {expr,e-Ssion-2 ( format " f mt " ) £ int-!2 >* 

SKIP f iat-U (LINES t int- 14 LINES &£ TEE) 

]_ int-14 LINES AFTER 

Many place clauses can be specified. Each place clause 
defined a line of output. One or more expressions can be 
assigned to an output line. Expression-2 is a numeric 
constant, a string of characters enclosed in double quotes, 
a prompt variable, a computed variable, a data item, or an 
arithmetic expression. The value of expression-1 is 
formatted according to the indicated fmt and is is placed 
int-12 spaces from the report page’s left margin. 

If the FORMAT option is omitted, a default format will be 
used. All default formats left justify expression values. 
The default format that is used for an expression depends on 
the type and size of its values. It also depends on how 
many positions are available for displaying its value 
(before the next expression's starting point on the line). 
In the following chart this number of positions is indicated 
by x. 



IXSSl 



Default. ; 

UNSIGNED 

1 or 

2 

"%-xu" 

UNSIGNED 

3 or 

4 

"%-xlu" 

REAL 

any 


"%-x. Of" 

INTEGER 

1 or 

2 

"%-xd" 

INTEGER 

3 or 

4 

" %-xld" 

BINARY 

any 


"%-xo" 

CHARACTER 

y characters 

"%-x .ys" 

STRING 

any 


"%-x.xs" 

IDEC 

z»Y 


"%-x .yf " 

TIME 

— 


"%-x ,9s" 

DATE 

— 


"%-x .10s 


The proper integer values for x and y are automatically 
determined, depending on value length and/or defined sizes 
of the expression's variables. Examples are shown in the 
generated programs that appear in Chapter VI. 


38 Rev. 85A 


(C) COPYRIGHT 1983 Micro Data Base Systems, Inc. 



MDBS RDL MANUAL - III. MDBS. RDL SPECIFICATIONS - MDBS RDL MANUAL 

Optionally, int-13 lines can be skipped before the output 
line and/or int-14 lines can be skipped after the output 
line. If neither BEFORE nor AFTER is specified, BEFORE is 
assumed. Thus, an int-13 of 1 results in single spacing, an 
int-13 of 2 produces double spacing, and so forth. If this 
option is omitted, single spacing is assumed. 

Examples: PLACE "NAME" @ 2 "ADDRESS" 8 20 

PLACE JDATE 8 30 SKIP 2 
PLACE FNAME @12 
LNAME 8 23 
"AGE" 8 40 

AGE 8 44 SKIP 4 LINES AFTER 
PLACE MOSAL 8 18 YRLSAL @28 TAX @38 


Special Case: Placing a Repeating Data Item 

A repeating data item can have multiple values. Using the 
above form of the place clause, will cause these values to 
be placed one beneath the other in a column indicated by 
int-14. This column of values begins after int-15 lines are 
skipped and is followed by skipping int-16 lines. If UNIQUE 
is specified, only the first value of a succession of two or 
more duplicate values is output. 

Greater control over the placement of a repeating data 
item's values is provided by an alternative form of the 
place clause. For a repeating data item, 

8 int-12 


in the place clause syntax can be replaced by 


int.~l,5 ACROSS CFRQM 
DOWN [£RQM (jjn.t.-20« J 


1 int-22 


Here, int-15 is a positive integer indicating how many of 
the repeating data item's values are to be placed on each 
line. For example, if there are 14 values and 5 ACROSS is 
specified, then the values are placed on three consecutive 
lines (with only four values on the third line) . The first 
value on each line begins in the column indicated by int-18, 
the second in the column indicated by int-19, and so forth. 
If fewer than int-15 column starting positions are 
specified, the remaining columns are automatically 
positioned so that an inter-column spacing of 2 results. If 
more than int-15 starting positions are specified, then an 
error message results. 
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Regardless of whether DOWN or ACROSS is specified, the 
report designer can optionally request that only some of the 
repeating values be output. This is accomplished by stating 
which value to begin with (as indicated by int-16 or int-20) 
and which value to end with (as indicated by int-16 or 
int-20). For instance, FROM (9,14) means that the ninth 
through fourteenth values of the repeating data item will be 
output. If int-16 (for ACROSS) or int-21 (for DOWN) exceeds 
the maximum replications of a repeating data item, then the 
maximum is used. 

Examples: 

PLACE PASTJOBS 3 ACROSS § 5,25,43 
PLACE LINE 2 ACROSS FROM (1,4) @ 2,52 
PLACE LINE DOWN FROM (3,5) § 12 


40 Rev. 85A 


(C) COPYRIGHT 1983 


Micro Data Base Systems, Inc. 


MDBS RDL MANUAL 


III. MDBS. RDL SPECIFICATIONS 


MDBS RDL MANUAL 


e) 


Sort groups clause (optional) 


SDRS! GROUPS BY 



[ASCENDING 1 

*1 


hi 

U 


DESCENDING 


• 

Lza j 

J 


This clause can appear as the last clause related to a group 
clause, providing the grouping is not by report or by page. 
The use of id-2 in a group clause produces groups of report 
details. These groups or "chunks" of report details can be 
sorted based on their values for id-3, which is either a 
data item or computed variable. Multiple sort criteria can 
be specified in any mix of ascending and descending 
directions. If no direction is specified, ascending is 
assumed. 

The sort groups clause does not affect the ordering of 
report details within a group; nor does it affect the 
ordering of lower level groups within each of groups being 
sorted. 


If the grouping for which a sort clause is specified is at a 
lower level than another grouping, then the sorting of the 
lower level groups takes place within each of the higher 
level groups. 


Examples : 


SORT GROUPS BY DESCENDING DEPTSALE 
SORT BY COMPTYPE, COMPNAME 
SORT ZA DEPTSALE AZ DEPTNAME 
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IV. USING THE MDBS. RDL SOFTWARE 

A. Overview 

The MDBS. RDL software is provided on several files. It consists 
of the RDL Analyzer, an RDL library, and the RDL sort-merge processor. 
The RDL Analyzer is used to convert RDL specifications into 
interactive C language programs. The RDL specifications are normally 
prepared with a word processor or text editor (the MDBS DDL Analyzer, 
for instance). The RDL library is used during the compilation of the 
generated C programs. The RDL sort-merge processor performs all 
sorting (if any) needed by the generated programs. 


B. The RDL Analyzer 

The RDL Analyzer consists of a file named RDL. In some 
environments, additional files named RDL1 , ..., RDL6 may also be 

provided. RDL is an executable file having the appropriate extension 
for executable files under the host operating system. The other files 
(if provided) are overlays needed by RDL during the Analyzer's 
execution. These files have OVL extensions. RDL, all of its 
overlays, and the main data base area should normally be on the 
default drive/directory when executing the RDL Analyzer. 

The RDL Analyzer is executed by entering the following operating 
system command line: 

RDL filename 

where filename is the name of a file containing an RDL source 
specification. If no extension is specified for this file, an RDL 
extension is assumed. If the filename is not qualified by a 
drive/directory indicator, the default drive/directory is assumed. 

If the User clause is omitted from the RDL specification's 
Identification section, then the RDL Analyzer will prompt for a user 
name and associated password. If a valid user/password is entered the 
Analyzer will continue its processing; otherwise, processing halts. 
RDL Analyzer processing can also be halted at any time by pressing the 
h ar d- i n t e r r upt key (e.g., Escape, Break, Control-C under many 
operating systems). 

There are three optional arguments that can appear in any order 
following filename on the RDL command line. These are 

-Uuser 

-Ppass 

-Ddb 

where user is a bona fide user name, pass is a valid password, and db 
is the (fully qualified) name of the file containing the data base's 
main area. If -Uuser appears, it overrides the user (if any) declared 
in the RDL specification and suppresses the RDL Analyzer's prompt for 
a user name. If -Ppass appears, it overrides the password (if any) 
declared in the RDL specification and suppresses the RDL Analyzer's 
prompt for a password. If -Ddb appears, it overrides the file 
specified in the Data base clause of the Identification section. 
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A fourth optional argument that can appear anywhere following 
filename on the RDL command line is 

-Bnnnnn 

where nnnnn is an integer number indicating how many bytes are to be 
allocated as a buffer for use by the MDBS Data Management System 
during RDL analysis. If this argument is omitted, approximately half 
of the available memory is allocated. In cases where the RDL 
specification is large, the -B option can be used to allocate a 
smaller buffer thereby leaving more room for RDL analysis. 


In some environments, a -I option can be used on the command line 
that loads the MDBS Data Management System. See Chapter VI of the 
MDBS System Specific Manual for your environment. If the -I option 
can be used for DMS/SMS loading in your environment, it can also 
appear as an option on the command line used to invoke the RDL 
Analyzer. Before a program generated by the RDL Analyzer can be 
executed, the DMS/SMS must be loaded (see Section D in this chapter). 
In cases where the -I option is not used for DMS/SMS loading, the -I 
option should not appear on the command line that invokes the RDL 
Analyzer. If the -I option is used for DMS/SMS loading it must also 
be used when invoking the RDL Analyzer. The interrupt number 
specified with -I must be the same in both places. 


If the RDL Analyzer detects an error in the RDL specification, 
then an error message is displayed and processing halts. Chapter V 
describes the possible error conditions. In cases where the Analyzer 
detects no errors, a message similar to the following is displayed 
upon completion of the program generation: 


RDL analysis complete: "rpgl.c" and "rpg2.c" generated 

Enter "crpg" to compile generated program(s) 

Enter "rpg" to execute compiled program(s) 


If the RDL specification's Identification section contains a Program 
clause, then the file name indicated in that clause replaces the 
letters rpg in the names of the files generated by the RDL Analyzer. 
For relatively simple reports, the rpg2.c program file is not needed 
and therefore is not generated. The three or four generated files are 
output to the default drive or working directory, unless a 
drive/directory qualifier is declared with the file name specified in 
a Program clause. Such a drive/directory qualifier will determine the 
drive to which the generated files are written. 
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C. Compiling the Generated Program (s) 

The RDL Analyzer produces a command file which, when invoked, 
will compile and link the generated program(s) . If no Program clause 
appeared in the Identification section, then the RDL Analyzer reports 
that this command file's name is crpg. Whatever its name is, it is 
invoked by entering the compilation command that the RDL Analyzer 
showed in double quotes. Type 

crpg 

for instance. Before invoking this command file, be sure that the 
generated program(s) , RDLIB, STDIO.H and (if necessary) your C 
compiler/linker software are on the default drive/directory. One or 
two additional files (SETJMP.H and/or RPGLOB.H) may have been provided 
with the RDL software. If they are provided, be sure that they too 
are on the default drive/directory prior to compilation. 

RDLIB is a library provided as part of the MDBS. RDL software. 
The C compiler that is used must be the C compiler with which MDBS 
interfaces under the host operating system. The SETJMP and RPGLOB (if 
provided) are C "include" files. The STDIO file is provided with the 
C compiler. 

Each compiled program will have the same name as its source code 
file, except that the c extension is replaced by the normal extension 
for an executable program under the host operating system. The 
compiled program(s) resides on the default drive or working directory. 
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D. Executing the Compiled Program(s) 

Prior to executing any application program (regardless of whether 
it was generated by the RDL Analyzer or written using traditional 
methods) MDBS must have been installed and, depending on the 
environment, its data management system must be resident in main 
memory. Instructions for accomplishing this appear in the MDBS System 
Specific Manual for C under your operating system. If MDBS is not 
resident, the message "Please load MDBS Data Management System" will 
be issued. This message can also be caused by inconsistent use of the 
-I option (i.e., the interrupt number used for loading DMS is not the 
same as that specified when invoking the RDL Analyzer) . 

Because the generated programs are in C, the C compatible MDBS 
interface must be used. For instance, the generated programs will not 
run with the MDBS data management system that interfaces to COBOL. 
Also prior to executing an application program, the data base itself 
must of course be on-line. 

The RDL Analyzer produces a command file which, when invoked, 
will execute the compiled program(s) . If no Program clause appeared 
in the Identification section, then the RDL Analyzer reports that this 
command file's name is rpg. Whatever its name is, it is invoked by 
entering the execution command that the RDL Analyzer showed in double 
quotes. Type 

rpg 

for instance. Before invoking this command file, be sure that the 
compiled program(s) and RDLSM are available for execution (e.g., on 
the default drive/directory) . RDLSM is an executable program provided 
as part of the MDBS. RDL software. In cases where multiple programs 
are generated by the RDL Analyzer, RDLSM is used during execution to 
handle all file sorting/merging activities on data extracted from the 
data base. 

Because the generated program invokes DML commands, it is 
possible that certain command status numbers can result from abnormal 
conditions during the course of execution. In such a case, the 
command status number is displayed and execution terminates. The 
meanings of command status numbers are documented in the MDBS DMS 
Manual . 

If a generated program is interrupted in the midst of execution, 
the data base is not closed. This does not harm the integrity of the 
data base. However, when you attempt to re-execute the report 
program, the message "Database already open" will appear and the data 
base will be closed. The report program can then be executed as 
usual . 
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The RDL Analyzer is able to detect a wide range of errors in RDL 
specifications. When an error is detected, the Analyzer ceases 
processing at that point and displays an error message. These 
diagnostics and their possible causes are described in this chapter. 
Because the RDL Analyzer contains portions of MDBS.DMS, it is also 
capable of producing a few command status messages. The command 
status numbers are documented in the MDBS DMS Manual. 


both operands of relational expression are constants or identical 

A relational expression cannot have constant operands on both 
sides of the relational operator (e.g., <, >, = , etc.), nor can 

it have the same operand on both sides. 

cannot mix place across with place down 

A Place clause cannot have both DOWN and ACROSS terms following 
the expression. 

cannot sort by 

The indicated term cannot be used in a sort clause. Data items 
and computed variables are the only valid sort keys. 

computed variable cannot depend on itself 

A computed variable cannot be defined in terms of itself. 

computed variable definition must start with ' { 1 

In a Computation clause, the declaration of how the computed 

variable's value is to be determined must begin with {. 

computed variable definition must terminate with 1 >' 

In a Computation clause, the declaration of how the computed 

variable's value is to be determined must end with >. 

computed variables are not allowed in FOR clause 

Computed variables are not permitted in a conditional expression 
(i.e., a logical expression beginning with the FOR keyword). 

conditional clause must contain a relational operator 

A conditional expression must contain at least one relational 
operator (e.g., >, <, =, etc.). 

conditional expression too long 

A conditional expression (i.e., beginning with FOR) cannot exceed 
512 characters. 
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current line exceeds 255 characters 

A line in the RDL specification cannot exceed 255 characters. 
For very long literals, use multiple Place clauses. 

data type not recognized 

An unrecognizable type has been specified for a function or 
variable. 

database access not allowed 

An invalid user/password combination was specified. A -B option 
was specified with a buffer size that is physically too small or 
too large. 

database and program names must be in quotes 

The name of a file holding the main data base area or a file 
specified in a Program clause must be enclosed in double quotes. 

default value's type incompatible 

The type of a specified default value is incompatible with the 
type of the prompt variable. 

expecting PROMPT/FUNCTION/COMPUTED/ or REPORT section 

One of these sections must appear following the Data base 
section. When used, they must appear in the correct order: 
Prompt, Function, Computed variable, Report details. 

FOR clause too complex 

The RDL Analyzer encountered a conditional expression (i.e., a 
logical expression beginning with the FOR keyword) that is too 
complex to successfully process. 

format specification is located after item being formatted 

In a PLACE clause, a format specification cannot appear prior to 
the expression whose values are to be formatted. 

format specification must be a string 

A format specification must follow the FORMAT keyword. It must 
be enclosed in a matching pair of double quotes. 

function definition must start with '{' 

A function computation clause must begin with {. 

function definition must terminate with 

A function computation clause must be terminated by } . 
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function not defined or not built-in 

A function referenced in the Computation clause is undefined or a 
non-built-in function is used following a conditional (i.e., FOR) 
expression. 

group HEADER or FOOTER expected 

Neither a HEADER nor FOOTER was specified for a group's Place 
clause. 

improper conditional clause 

The conditional expression (i.e., a logical expression beginning 
with the FOR keyword) does not have a valid syntax. 

IN operator must occur within conditional clause 

The IN operator cannot be used outside of a conditional (i.e., 
FOR) expression. 

in report detail, SORT clause follows THRU clause 
A Sort clause cannot follow the Thru clause, 
incorrect SORT syntax 

Some word other than AZ , ASCENDING, ZA, or DESCENDING was used to 
specify sort ordering. 

insufficient room in memory 

The RDL Analyzer does not have enough room to execute for an RDL 
specification of this size. Use a smaller specification (e.g., 
eliminate non-essential Place clauses) or a smaller -B option on 
the command line that invokes the RDL Analyzer. 

invalid arithmetic expression 

An invalid arithmetic expression was encountered (the parentheses 
are not balanced, there is an operator-operand mismatch, a 
keyword is improperly used, etc.). 

invalid IN usage 

The operand to the right of the IN operator must begin with [ and 
end with ] . 

invalid name 

An invalid name was specified for a prompt variable, function, 
function parameter, or computed variable. Names must be 
alphanumeric and cannot begin with a numeral. 
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invalid record type 

The indicated record type is not valid for this data base, 
invalid syntax in path clause 

A delimiter other than ' or a blank has been 

specified in the Thru clause. 

item is not in record type 

The indicated data item does not exist in the record type that 
was used to qualify its name. 

item is not unique within specified path 

The report references a data item that exists in more than one 
record type involved in the relationships specified in the Thru 
clause. Qualify the data item by prefacing it with its record 
type name. 

item is not within the specified path 

The RDL specification refers to a data item that is not in any 
record types lying along the path specified in the Thru clause. 

item used in computed variable definition is not recognized 

A non-existent data item, prompt variable or computed variable 
was referenced when defining a computed variable. 

left parenthesis expected before argument list 

A function's arguments must be enclosed in parentheses. 

mismatched curly brackets 

Unbalanced curly brackets ({,}) have been used. 

mismatched parenthesis 

Unbalanced parentheses have been used. 

missing closing parenthesis or incorrect number of arguments 

A function's arguments must be enclosed in parentheses and the 
correct number of arguments must be specified. 

must group by database item 

Only data items can be used as the basis for grouping. 

must sort by database item or computed variable 

Only data items and/or computed variables can be used as the 
basis for sorting. 
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no items specified 

The RDL specification does not involve any data items from the 
indicated data base. 

no sets specified in THRU clause 

The Thru clause must include one or more set names. 

number expected 

A number must be used with specifying coordinates, how many lines 
to skip, or the size of a variable. 

output device not recognized 

The output device must be either SCREEN, PRINTER, or a quoted 
file name. 

page size/left/top margin should be numeric 

Page size, left margin, and right margin must be numeric. 

percent computed variable cannot be placed in group section 

A computed variable defined in terms of the built-in percent 
function cannot be referenced in the Group section. 

rdl source file not present 

An RDL source file was not specified on the command line used to 
invoke the RDL Analyzer or the specified file is not present on 
the appropriate drive. 

REPORT section is required 

The Report details section is required in every RDL 

specification. It begins with the REPORT keyword. 

set is invalid 

Every set specified in the Thru clause must exist in the data 
base schema. The first set specified must be owned by system. 

set is not connected within specified path 

A completely connected line cannot be drawn through all sets 
specified within the Thru clause. 
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set is superfluous to report writing 

The indicated set is not needed to produce this report. 
Eliminate it from the RDL specification. 

string must terminate with " on current line 

A string constant cannot be broken across multiple lines and it 
must terminate with ". 

THRU clause is required 

The Thru clause must appear at the end of the Report details 
section. 

token not recognized 

The most recently specified token (e.g., keyword, variable, 
special symbol, etc.) is unrecognizable. It is misspelled, out 
of correct syntactic order, etc. 

too many column coordinates 

When using ACROSS in a Place clause, too many coordinates were 
specified for the number of values to be placed. For instance, 
more than 5 coordinates were specified for 5 ACROSS. 

too many computed variables used in current computed variable 
definition 

No more than 10 computed variables can be referenced within a 
computed variable definition. 

too many items specified 

No more than 102 data items can appear in an RDL specification. 

too many operands/operators 

The number of operators/operands make the RDL specification too 
complex to be processed. 

verb PLACE expected 

Each Place clause must begin with the PLACE keyword. 

* and / are not unary operators 

These arithmetic operators must have 2 operands. 
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This chapter contains several sample RDL specifications. Each is 
used to describe a desired report to be obtained from a data base 
having the schema shown in Figure VI-1. The formal DDL specification 
for this schema appears in Figure VI-2. The RDL Analyzer was used to 
process each of the RDL specifications appearing in this Chapter. The 
generated program(s) for each was compiled and executed against a 
loaded data base. In this chapter, the resultant output report for 
each example RDL specification is reproduced alongside that 
specification. For the first two examples the generated source 
program is also shown. All of these examples were run under the PCDOS 
operating system and therefore used the MDBS interface to Lattice C 
(also known as Microsoft C) . In other environments the RDL 
specifications and resultant reports are identical to those shown 
here. However, the generated source code may differ slightly from the 
two examples shown here due to differences in C compilers. 


IEMP 



Figure VI-1. Sample Schema 
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/■*•**** 

* 

* samole data bas* description (advanced level) 

* 

»**•**/ 

db ioos file " jobs.db" 

aide 50 pages, pace size 512 


OEFAULT DEFINITION 

default for char ts 8 
default for bin is 250 
default for str is 50 
default for unsigned is 2 


/ii***sj*s***>^****»# USER DEFINITION ******»*e****>**»*-^^*^-.>^>/ 

user "user" with "pass" read access (a-p) ur i te access (a-p) 
user g3ry" u i tn 'rush" read access (a-p) write access (s-p; 


/s****^*.*^*,.,*,^** AREA DEFINITION *i.i,.»»**,>*t>^**i«****»i,** / 

area name is iobl 

file name is "jobl.db" 
size is 20 pades 

paae size is 512 /> Note: this pade size would not be 

allowed in Version 3a because 
the iiia in area ’ s paae size is l02e */ 
read access is (a-p) write access is (a-p; 


area job2 file "job2.db" 

size 20 pages 
read ( a-g ) write (a-p) 


RECORD TYPE DEFINITION s***********************/ 

record DEPT 

in lubS fey is NAME nodup 
title is "this is a title" 
re3d access e write access ta,b) 
item OMUfIB-ER mt l 

rande i s 1 to w2 
syn i s DM0 

item is NAME char 12 encrypted 
urite access b 

i tern LOCATION str 35 sun LUC 

range "A" to "ZZZZZZ" 


record emp louee in job!, Key is ID noduo 

react access < a » cl > write access ;3>p^ 

item ID char l.l encrypted rsnqe is "0" to "9?99 9?999" 
item lASTNAOE char 20 

item FNAME str 12 range "Aa " "Zz" 

I tern PASTJCB str 25 occurs 3 times 
item YTDEARN idee 7,2 


record BIOGRAPH in |od2 

read access b write access p 

i tern LINE str occurs 5 times 

Figure VI-2 . Sample DDL Specification 
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record SKILL in <jobS.job2) calc key is SKILCODE nodup 
read access (b.d) write access f 

item SKILCODE uns i qned syn SC ranqe 0 to 3000 
item DESCRIPT str 55 

item RATING real 2 ranqe 0.0 to 4.0 


record job /» in area o +' member of NEEDS */ 
read access 0 write access (a. pi 
item jobcode uns i aned 1 
anae l to 
00 

item DESCRIPT str 


SET DEFINITION 

set I EMF* . type 1 : n . retention fixed 
read access d write access p 
owner SYSTEM 

member EMPLOYEE. order sorted by ascendina ( lastname. Frame; 
i nsert i on auto 


set POSSESS, type n:«i 

read access a > d ; write access i.f,p) 

owner EilPLQrEE. order sorted by As ID 
member SKILL 


set DETAILS, tyoe l : 1 . fixed 

read access ’.b.d.) write access p 
owner EMPLOYEE 
member SIQGRAPH auto 


3et FILlEDSt, type 1 : n 

read access '.a-d; write access p 
owner job 

member EMPLOYEE f i fo auto 


set NEEDS n '• m 

read access b urite access 'f.p> 
owner JuB sorted :3 JGBCQDE 
member SKILL sorted 3 ; 1 RATING. SKILCODE ; 


set HAS l ' i'i 

read access (a.b> write access a 
owner DEFT 

• member EMPLOYEE lifo ?u < o 

set IDEP l:n read access b 

owner SYSTEM member DEPT auto 


set I job i:n read access b 

owner SYSTEM member .job auto fifo 

END 


Figure VI-2. 


Sample DDL Specification (Continued) 
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Example 1 


RDL source specification (page 58) 

Generated C source program (pages 59 and 60) 

One-page output report (page 61) 

User responses to prompt variables: 

NLINE - user pressed Enter key (« *) resulting in 

default of 30 
OUTDEV - user entered SP 


the 
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* SAMPLE RDL SOURCE 1 

ft 

ftftftftftftftftftftftftftftftftftftftftftftftftftftftftftftftttftftftftftftftftftftftftftftftftftftft 

/ft*.*....*...**............*... 

c 

* database section 

* 

ft.*..**...******.***....*....*/ 

database file name is "jobs.db" 
user "user" with "pass" 


prompt variables 


prompt 

NLINE int 2 

"No. of lines per page ?* default 30 
OOTDEV char 7 

“printer, screen, or disk file 7* 


output control section 

ft*.******.********.*.../ 

page size is NLINE lines per page 

device is OUTDEV 

pause 


report section 


report is 

place unique FNAME 0 1 

underlined PASTJOB 2 across 0 10, 22 
underlined LINE 2 across from (2, 5) 0 34, 50 
• ■ 0 74 

for (FNAME in l ‘Bob", ‘J (a , e] nnie " , "D«", "C*"]) 

thru 

-iemp details 


/ 


group section 


/ 


group by PAGE 
header 

place ‘EMPLOYEE FILE" 0 33 skip 3 after 
Place 

0 1 

place "First Name" 0 2 

■Past Jobs’ 0 13 

"Vita" 0 36 

Place 

0 1 skip 3 after 
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else C 

p b 1 a n k ( 9 > ; 

mpr intt( "7.-12. 12s" , RV_3£23 > ; 
pblar.k<12>; 

mpr lrtf ( “7.-16. 16s " , RV_2C-33 ) ; 
mpr i n t f ( 16. 16s" , RV_2C 4 ] ) ■ 

m p r i n t P < " X- 1 . 1 s " , " " > ; 

update ( ) 

•C 

if (rpstart) C 

0 t a b 1 = rt a. b 1 ; 
otab 2 = rta.b2; 

p g f *:< o t 'V r ( ) 

sk i p 1 i ne ( 1 ) ; 

_pg pause ( ) ; 

pdp ( ) 

1 f ( ! rpend 11 r _ p f o t ) C 

UPAGE++? 

mpr i n t -f < 10. 1 Os “ , IJDATE ) ; 
pb 1 ar.k ( 35 > ; 

mpr i n t 4 ( "PAGE y.d\n", UPAGE); 
curl i ns+*i 


pgheader ( ) 

pgcheck ( 1 , out Ctrl C23 + 32); 
mprintti "7.-13. 13s", "EMPLOYEE FILE" ) ; 
s k i p 1 ine( 3) ; 

p g c h e ■: k ( 1 . ou tetri C23 + 0 i • 

pgcheck ( 1 , outctr 1C23 + 1); 
mp r i n t f ( " 7. - 1 1 . 12s", "First Name ">• 
mpr i n t f ( "7.-23. 23s " , "Past Job s " ; : 
mpr l n t f < " X— 4 . 4s " , " Vi ta" ) ; 
p g c ti eck ( 1, o utctrl C23 0 > ; 

================ " ~ 

s k i p 1 me ( 3) ; 
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Dons l d 


Chsr l es 


Deanna 


SW§ii^i , _§0§Iy9CQyE_!Q3nagesingl.e tioC9-iD_Lsbsnon i _ 

&C99r§U!!8*C_ rt .S^Management (S§(jiP*r_!3nS0LN 

§ccgyntant_ IRS_investigsingle 9Qrn_in_Tulahgm3 _ 

6SQ!i_Sii€!SiQ* ElDr? r_Creatiye_Amember _SSED 

!!>§9i£iil] comedian married horn in Remmgto 

I I I II IIIIIII XXXXXXXXXXXXX.I memher_|EAQrFQR-' 

cashier single t>BCh_in_Dautgn 1 _ 

BCQ3C3mmer_ • _N3tb*t‘J3tics 

b.ar3te_instrFe.X_£i , si9_ins i ngie frorn jn__stinkj.ng_ 

iQi'JiSl_SC§i n (1 . S i _Rsyco t ogy_ memher _Homemaker_ 

singer telephone opmerried _ horn in Sp i throo 

£3lk_=hgy_ho B.S._Physi.cal edmember IIKMN 

B 9 liC*_g££iC dancer single ?orn _ m_Bondshrg_ 

hoxer fl ._3 i _Ciy i l_eng mmember._ JtJ IflKL 
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Example 2 


RDL source specification (page 64) 

Generated C source specification (pages 65 and 66) 
Five-page output report (pages 67 through 71) 

User response to prompt variable: 

OUTDEV - user entered SP 
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SAMPLE RDL SOURCE 2 


* 




/ 


database section 

*******44*a**********«***4*** / 


database is *jobs.db* 
user "user" with "pass" 


/ 


prompt section 


/ 


prompt variable 

OUTDEV string 10 

"Output device ?* 


/ 


environment section 


/ 


page site is 50 lines per page 
device is OOTDEV 


/ 


computed variable section 

***•••**«***•*.*•*•«**•/ 


computed variable 

ERNTTL idee 7,2 

{ sum ( YTDEARN) > 


**** 

# 

* 

report 

section 

»** 



**** 

********* 


>**/ 




report 

is 






place unique 

FNAME 

8 

1 



unique 

LASTNAME 

8 

10 



unique 

SKILCODE 

8 

24 




YTDEARN 

8 

34 




PASTJOB 

8 

47 skip 1 after 


thru 







idep has possess 



* 

* 

group 

section 




*«** 



>*«/ 




page break at D NUMBER 


group by PAGE 
header 


place 

place 

"EMPLOYEE FILE" 

8 

33 

skip 1 line 


8 

1 

skip 2 lines 

place 

"First" 

8 

1 


"Skill code" 

8 

23 



■Salary" 

8 

34 


place 

"Past Jobs" 

8 

46 

CC3CC 



8 1 skip 2 after 

group by D NUMBER 
header 

place "Department number" 8 1 

DNUMBER 8 20 skip 2 lines after 


footer 

place "Department earning total 
ERNTTL 


" 8 1 
8 29 

skip 3 

Micro Data Base Systems, 
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el SO C 

p b 1 a n k (10); 

mpr ir.tf ( "7.-13. if", RV_3> ; 
mprintf < " 7.-25 . 25s " , RV_2C i ndx 13), 
i nd> 1 ++; 

sk i p 1 i no < 1 ) ; 

u b r k ( ) C 

brkflagCiD = (RU _1 '= btrrr.2!) ; 


a b r k 2 ( ) 

if < ( brkf 1 ao C23 ‘,1 rpend) ?<?< ( !rp start)) C 

pgchsckO, outctrl C23 +■ 0); 
mprintf ( "X— 23.2Ss", "Dopar tmer.t ear nin'] 
mpr intf < "7.-13. 2f" , ERNTTL COD; 

ERNTTL C03 = 0; 
g r p b r k C 2 3 = TRUE; 


bbrk2( ) 

,r 

v 

if ( brkflagC23 ! I rpstart) C 

pgchocktl, outctrl C 2 3 + 0), 

mpr- i nt f ( "7.-1 1 9s ", "Dopar tmor.t number 

mpr i nt f ( "7.-5d " , RV_1 ) ; 

S k 1 p 1 100(2); 

btrm2 = RV_1; 


>j p d a t o ( ) 

r 

i f ( rpstart ) C 

ERNTTL CO 3 = 0; 

if C(rtab2 ! = otab2) !! (rtabl ' = otabl)) 

r 

ERNTTL C03 += RV_3; 

o t a b 1 = rtabl; 
otat-2 = rtab2; 

<:• tat' 3 = rtab 3 ; 

pdp ( ) 

if ( 1 rpend 11 r _ p f o t ) C 
UPA0E++. 

mp r i n t f ( " '/. 10. 1 Os " , UDATE ) ; 
pb 1 ar.k ( 55 ) ; 

mpr i n t f ( "PAGE 7.d\r.", IJPAGE); 
cur 1 ine++; 


pghoador ( ) 


p g c h e c k ( 1 

, utct r 

1 C23 + 32) ; 

mp r i r. t f ( “ 

7.-13. 13s 

' EMPLOYEE FILE"); 

pa check ( 2 

, outctrl C 2 3 + 0 > ; 

mpr i o t f ( " 

7.-63. 63s 

ii it — = — =: 

pgchock ( 1 

, outctrl C23 + C> ) , 

mpr i o t f ( " 

7.-3. 3s" , 

'First" ) ; 

rr»p rintt ( " 

7.- 1 4 . 14s 

‘ y " Las t Name 11 ) • 

mpr i nt f ( " 

V.- 1 1 . 1 1 s 

' , “Skill cede"); 

mpr i n 1 1 ( " 

7.-12. 12s 

’ , "3a 1 ary" ) ; 

Hi p- r intf (" 

7.-9. 9 s" , 

'Past Jobs"); 

pgc hoc )' ( 1 

, outctrl C 2 1 + 0); 

m p r l n t f < " 

7.-63. 63s 

- 


========" > . 

S k 1 p 1 100(2); 


total : " > ; 
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10/07/1983 


PAGE 1 


EMPLOYEE FILE 


Skill cod* Salary Past Jobs 


Department number 1 


Gould Mcmullan 2508 


Leo Gramstad 2745 


13000.00 

13000.00 

13000.00 

10000.00 
10000.00 
10000.00 


park mans per 
sales clerk 
security deputy 

apartment manaqer 

handuman 

carpenter 


Bob Amines 


9000.00 sinqer 

9000.00 telephone operator 

9000.00 talk show host 


Deanna Anderson 1130 


11000.00 karate instructor 

11000.00 FBI field invest i pator 

11000.00 animal trainer 


David Ahrendt 


15000.00 

15000.00 

15000.00 


pot ice of f i c er 

d3ncer 

toner 


15000.00 

15000.00 

15000.00 


police off i cer 

dancer 

boxer 


15000.00 

15000.00 

15000.00 


police off i cer 

dancer 

boxer 


Department earn i no total 
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10/07/1983 


EMPLOYEE FILE 

PAGE 5 

F i r st Last Nam* 

Skill 

code Salary 

Past Jobs 

Department number 




Richard flauersta i n 

2502 

9900.00 

computer operator 



9900.00 

bartender 



9900.00 



2306 

9900.00 

computer operator 



9900.00 

bartender 



9900.00 


Kirk Kommick 

1852 

14000.00 

market analyst 



14000.00 

nurvs* 



14000.00 

civil enq i neer 

Aaron Galahad 

2305 

11300.00 

programmer 



11300.00 

volunteer fireman 



11300.00 

pastry chef 

Burton Backoff 

1203 

32000.00 

system engineer 



32000.00 

programmer 



32000.00 

cost controller 

Franc me Franzmeier 

2029 

23000.00 

system programmer 



23000.00 

accountant 



23000.00 

pro lect analyst 

(Department earning 

total : 

90200.00 
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Example 3 

RDL source specification (pages 74 and 75) 
Eight-page output report (pages 76 through 83) 
User response to prompt variable: 

OUTDEV - user entered SP 
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* SAMPLE RDL SOURCE 3 * 

e * 

»•*****«•**•****»»«•»**»**«•«>*»»»*****«**«»****»*»•***»»»**»************»«***»***»»* 

/ft***************************** 

ft 

* database section 

« 

ft*****************************/ 

database is "jobs.db* 

user name is ’user" with "pass* 

/**•••**. ••*****•**•••*******•• 

* 

• prompt section 

* 

ft*****************************/ 

prompt 


OUTDEV string 7 

• printer or screen 7 " 


output control section 

page size is 50 lines per page 

device is OUTDEV 

pause 


/ 


* computed variable section 

ft.ftft.ftftftftftftftftftftftftftftftftftftftftftftft**/ 


computed variables are 

PI idee 5,2 

{ percent (YTDEAR, DNUHBER) > 

EMPTTL int 2 

{ count (ID) ) 

SI idee 11,2 

( stddev < YTDEARN) > 


/****•«. •*•«*»*«»«•**********•* 

* 

* report section 

* 

••••••••ft*********************/ 


report is 

place underlined unique DNUMBER @ 3 

unique FNAME § 9 

unique YTDEARN - (0.1 * YTDEARN) 9 19 
PI 9 32 

EMPTTL 8 52 

skip 1 after 


thru idep has 
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group section 

**•**.*»***•**. ***•**.*/ 

page break at D NUMBER 

group by REPORT 
footer is 

place “Total number of employees:" § 10 

EMPTTL 8 38 Skip 5 

place “Standard deviation of year-to-date earning:" 8 10 
SI 8 57 skip 3 

group by PAGE 
header is 

place “EMPLOYEE FILE* 8 33 skip 1 line 
place 

8 1 skip 2 lines 

place “Dept.* 8 2 

"First Name* 8 8 

"Earning* 8 19 

"Percent Earning" 8 32 

•Company employee total" 8 52 

Place 

8 1 skip 1 lines after 

footer is 

place "Employee total : " 8 30 

EMPTTL 8 48 skip 5 

group by D NUMBER 
header is 

place "Employee Listing for Department I" 81 skip 2 lines 

place D number 8 36 skip 0 before 2 after 

footer is 

place " standard deviation for department* 8 5 

D NUMBER 8 41 

*:* 8 45 

SI 8 47 skip 3 lines 

place SI 8 45 skip 2 


(C) COPYRIGHT 1983 Micro Data Base Systems, Inc 


75 



MDBS RDL MANUAL - VI. RDL EXAMPLES - MDBS RDL MANUAL 



6 


(C) COPYRIGHT 1983 Micro Data Base Systems, Inc 












MDBS RDL MANUAL 


VI 


RDL EXAMPLES 


MDBS RDL MANUAL 



78 


(C) COPYRIGHT 1983 Micro Data Base Systems, Inc 





9 










MDBS RDL MANUAL 


VI . RDL EXAMPLES 


MDBS RDL MANUAL 



80 


(C) COPYRIGHT 1983 Micro Data Base Systems, Inc 



MDBS RDL MANUAL 


RDL EXAMPLES 


MDBS RDL MANUAL 



(C) COPYRIGHT 1983 Micro Data Base Systems, Inc 


8] 







MDBS RDL MANUAL - VI. RDL EXAMPLES - MDBS RDL MANUAL 



82 


(C) COPYRIGHT 1983 Micro Data Base Systems, Inc 











MDBS RDL MANUAL - VI. RDL EXAMPLES - MDBS RDL MANUAL 


This page intentionally left blank. 


84 (C) COPYRIGHT 1983 Micro Data Base Systems, Inc. 



MDBS RDL MANUAL 


VI. RDL EXAMPLES 


MDBS RDL MANUAL 


Example 4 


RDL source specification (pages 86 and 87) 

Nine-page output report (pages 88 through 96) 

User responses to prompt variables: 
outdev - user entered SP 

PAGESIZE - user pressed Enter key resulting in the default 
of 50 

LFTMGIN - user pressed Enter key resulting in the default of 
5 
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* SAMPLE RDL SOURCE 4 

* 




/ 


* database section 

* 

4**«£ti«A£*************ft*******/ 

database is "jobs.db* 

/*•*•**•**••*.*..***••**•••**.. 

* 

* prompt variable section 

* 

****.******.****.*.«...*«***.*/ 


prompt 


OOTDEV string 7 

■Screen or Printer 7* 

PAGESIZE int 2 

'Number of lines per page : * default 50 

LFTMGIN int 2 

•Left margin : * default 5 


* 

* output control section 

. 

*•*•'*•**••••••****•*•***«***••/ 

page size is PAGESIZE lines per page 

left margin is LFTMGIN 

top margin is 4 

device is OUTDEV 

pause 


/ 


function definition section 


function f indraise (pi) idee 5,2 

pl int 
t 

if (pl > 1) 

return (YTDEARN * 0.10); 

else 

return (YTDEARN * 0.06); 

) 


computed variable section 

***•.*****..*...*•**.**/ 

computed variables are 


EMPTTL 

int 1 

{ count (ID) ) 

ERNTTL 

idee 7,2 

{ sum (YTDEARN) ) 

SKILNO 

int 1 

{ count (SKILCODE) 

RAISE 

idee 5,2 

i findraise (SKILNO) 

HIJOBCODE 

int 1 

( max ( JOBCODE) ) 

LOSKILL 

int 2 

( min (SKILCODE) } 
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report section 
*•**•«***•****••*••****/ 
report is 

place unique DNUMBER t 3 f 3 


unique ID 0 9 

unique JOBCODE § 23 

unique SKILCODE 0 33 

PASTJOB 0 43 

unique RAISE 0 65 


thru 

idep has 

possess >filledby details 


/**«•••**•*••*»*•***••***•*•*** 

* 

* group section 

* 

••••••*»••••*****•***•**••••*•/ 


page break DNUMBER 
group by PAGE 


header 




place 

'FOR INTERNAL 

CIRCULATION 

: via proper channel* 


0 20 

skip 2 

place 





0 1 

skip 3 lines 


place 

"Dept" 

0 1 



"Soc-Sec-No. * 

0 8 



•Jobcode' 

0 22 



"Skillcode" 

0 32 



'Past jobs' 
■Sugg. Raise' 

0 24 

0 64 


place * — — — — — - — 

0 1 skip 1 line before 2 after 

group by DNUMBER 
header is 

place 'Department number : * 0 1 
DNUMBER 0 25 

footer is 


place 

"Department 

employee total ; * 

0 

10 




EMPTTL 


8 

39 

skip 2 

lines 

place 

■Department 

salary total : * 

0 

10 




ERNTTL 


0 

39 

skip 2 

lines 

place 

'Department 

skill count : * 

0 

10 




SKILNO 


0 

39 



place 

"Department 

highest jobcode : * 

8 

10 




HIJOBCODE 


0 

39 



place 

■Department 

lowest skilcode : * 

0 

10 




LOSKILL 


§ 

39 




sort by descending HIJOBCODE 

group by ID 

header 


place 

"Personal information for 

' 0 10 




FNAME 

0 40 




LASTNAME 

0 50 

skip 2 

line 

place 

LINE 

0 12 

skip 1 

after 


footer 


place 

"Skill count is • 

0 15 


SKILNO 

0 31 

skip 2 lines 

place 

"Low skill code is" 

0 15 



LOSKILL 

0 33 



sort by ascending HIJOBCODE SKILNO 
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Department number : 


Personal informat i on for Erica 

age 36 
marr i ed 

born in Plainfieldt New Jersey 
Ph.O. Management 
member VIPF'L 


332-55-419? 


technical advisor 1440. QO 

production supervisor 
system ansly;:er 


Skill count is 1 
Lou skill code is 2542 


Department employee total : 
Department salary total •' 
Department skill count '• 
Department niqhest |obcode 
Department lowest skilcode 


24000.00 

l 

: 51 
2542 
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PAGE 2 


FOR INTERNAL CIRCULATION: via proper channel 


Dept Soc-Sec-No. Jobcade Skillcode Past jobs Sugg. Rais* 


Department number : 5 

Personal information for 
age 29 


single 

born in Dayton, Ohio 
B.A. Plathematics 


Charles Grupenhoff 


3 


5&2-73-1263 91 


2563 


clerk 
cash i er 
programmer 


Skill count i s 1 
Low skill code is 2563 


Personal information for Silver Knight 

3ge 30 
inarr i ed 

born in Biggers, Arkansas 

xxxxxxxxxxxxxx 

member EAT-FOR-HEALTH 


376—96—8369 92 1769 


Skill c ount i s 1 
Lou skill code is 1769 


c 1 erk 

postal carrier 
author 


Dep artment 
Department 
Department 
Department 
Deo artment 


employee total : 
salary total : 
skill count : 
h i ghest jobcode : 
lowest sk i Icode : 


33000.00 

92 

1769 


720.00 


1260.00 
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Department number : 


Personal information for 
age 34 
single 

born in Tulanoma. Tennesse 
Ph.O. Creative Accounting 
member SSED 


Jann i e 


342-89-1111 


accountant 

IRS investigator 

bank exam i ner 


2520.00 


3k i 1 1 count i s 1 
Low skill code i s 


Personal information for Carl 

age 42 

mar r i ed 

born in Remington. Virginia 

xxxxxxxxxxxxx 

member PEAO-FOR-PLEASURE-eOOK-CLUB 


Gudman 


659-56-9376 31 


maq i c i an 
corned i an 


672 . 00 


Skill count i s 1 
Low skill code is 2653 


Department employee tot3l : 
Department salary total '■ 
Department skill count : 
Department highest lobcode 
Department louest sk i Icode 


53200 . 00 

O 

' 31 
: 2326 
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Department number 


Personal information for 
age 28 
marr i ed 

born in Fayettev i l le r SC 
m.S. Computer Technology 
Member XI SIGMA 


Franc ine Franzmeier 


1 26-35-7123 11 


Skill count i s 1 
Lou sk i l l code i s 2029 


system programmer 
accountant 
project analyst 


1380.00 


Personal information for 
age 37 
marr i ed 

born in Le::ington> flass 
F'h.D. Mathematics 
member K I LIANA club 


Burton Backoff 


373-56-1422 


system engineer 
programmer 
cost control ler 


1920.00 


Skill count is l 
Low skill code is 1203 

Personal information for 
age 26 
marr i ed 

born in Chatanoogar Tennesss 

6.S. English 

member Writers' guild 


131 -a5-3219 


programmer 
volunteer f i reman 


678.00 
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10/10/1983 PAGE 5 


FOR INTERNAL CIRCULATION: vis proper channel 


Dept Soc-Sec-No. Jobcode Ski llcode Past jobs Suqd. Raise 


231-45-3219 13 2305 pastrq chef 678.00 

Skill count i s 1 
Lou skill code is 2305 

Personal information for Kirk Kommick 

age 27 
marr i ed 

born in Chicado, Illinois 
6.S. Engineering Science 
member XILS 

376-45-6219 14 1352 market analust 840.00 

nurse 

civil end i neer 

Skill count i s 1 
Lou skill code is 1352 

Personal information for Richard flayersta i n 

age 25 
marr i ed 

born in Lancaster. Neu York 

xxxxxxxxxxxxxxxxxxxx 

member UNIG 


1 *f5*-63-3284 

15 

2502 

computer operator 
bartender 

594.00 



2306 

computer operator 
bar tender 

990.00 
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department number 


Personal information for Dav 

age 27 
single 

born i n Bondsbrook , New Jersey 
(1.3. Civil engineering 
member JUIflKL 


123-34-9875 1 


po l ice off i cer 

dancer 

bo::er 

police officer 

dancer 

boner 

police off i cer 

dancer 

boxer 


900 . 00 


1500.00 


5k i l l count i s 3 
Low skill code is 1001 


Personal information for Deanna 

age 35 
single 

born in stinking creek- Tennesse 
n.S. Psucology 

member Homemakers’ association 


Anderson 


453-34-76° 


karate instructor i 

FBI field investigator 
animal trainer 


Skill count i s 1 
Low skill code is 1130 


Personal information for 
age 37 
inurr i ed 


Or amstad 
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Department 

Department 

Department 

Department 

Department 


employee total : 
salary total : 
skill count : 
highest jobcode : 
l ouest sk i Icode : 


58000.00 

7 

5 

1001 
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Example 5 


RDL source specification (pages 98 through 100) 

Fourteen-page output report (pages 101 through 114) 

User responses to prompt variables: 

UNAME - user pressed Enter key resulting in default 
UWORD - user pressed Enter key resulting in default 
LFTMGIN - user pressed Enter key resulting in default 
MAXLINE - user pressed Enter key resulting in default 
OUTDEV - user entered SP 

TITLE - user pressed Enter key resulting in default 
CONST1 - user entered 0 

UDATE - user pressed Enter key resulting in default of 
computer's internal clock date 
FOOTNOTE - user entered sampl5.rdl 
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* . 

* SAMPLE RDL SOURCE 5 • 

* * 
*••*•***•*********•******•*****••*«********•*•*•******•***** ***»**»*»**,, „***,*,*,,* 

/**«****************«********** 

* 

* database section 

* 

**********«**•*********«•*****/ 

database is "jobs.db" 

user name is "user* with "pass* 

/A***************************** 

* 

* prompt variable section 

* 


prompt variables are 

UNAME string 10 

‘Enter user name i * 
default 'user* 

UWORD string 10 

■Enter user password ; * 
default ’pass* 

LFTMGIN int 2 

“Page left margin is : ■ 

* default to 2 

MAXLIKE int 2 

"Kumber of lines per page : * 
default to 45 

OUTDEV string 7 

■printer or screen 7 * 

TITLE string 40 

“Enter string for page title : * 

default to "Monthly Employee Detail Report" 

CONST1 int 2 

prompt with "Report is for dnumber > ? ’ 
default 2 

UDATE string 10 

"Enter today's date s • 

FOOTNOTE string 40 

"Enter string for footnote : " 

/**********************•******* 

* 

* output control section 

* 

page size is MAXLINE lines per page 
left margin is LFTMGIN 
top margin is 4 
device is OUTDEV 


* 

* function definition section 

* 

*•*•**. .*************.*******«/ 

function computaxtpl) real 4 
pi idee 
{ 

if (pi < 1000.0) 

return (0.0) ; 

else 

return((pl - 1000.0) * 0.1); 

) 
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computed variable section 



k ******* / 


computed variables are 

EMPTTL int 1 

{ count (ID) ) 


ERNTTL 

idee 7,2 

( sum ( YTDEARN) ) 


AVGPAY 

idee 7,2 

( average (YTDEARN) ) 


TAXWHLD 

idee 7,2 

( C0KPUTAX (YTDEARN) ) 


TAXStJH 

idee 7,2 

{ sum (TAXWHLD) } 


AVGTAX 

idee 7,2 

{ average (TAXWHLD) ) 


report section 




******* / 


report is 



place 

•Department no:’ 

8 10 


DNUMBER 

8 30 

place 

a 

a 

place 

"Employee name:" 

TTo 


FNAHE 

8 26 


LASTNAME 

8 36 

place 

a 


place 

"Social security 

no : " 


ID 


place 

a 

a 

place 

"Past job experiences 

place 

underlined PASTJOB 

place 

"Skill codes" 

8 10 


SKILCODE 

8 23 


"Jobcode : " 

8 32 


JOBCODE 

8 42 


place " ' ! 22 

* ’ 8 41 

"Year to date earning:" 
underlined YTDEARN 
place "Federal withheld tar : 
underlined TAXWHLD 


skip 2 lineB 
8 28 


" 8 25 

8 10 

8 32 
8 30 
8 10 

8 15 


8 10 
8 32 
" 8 10 

8 33 skip 2 


for DNOMBER > CONST1 


thru 

idep has 

possess >filledby 
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group section 

«******•**«•. *.*.**...«/ 

page break at D NUMBER 


group by REPORT 
footer is 

place ’SUMMARY* a 30 

skip 5 lines 

place ’ a 28 

place ’Total company employee income : * 8 10 

underlined ERNTTL 8 45 

skip 3 lines 

place ’Total company employee number : * 8 10 

underlined EMPTTL 8 45 

skip 2 lines 

place ’Average company employee income : ’ 8 10 

underlined AVGPAY 8 45 

skip 2 lines 

place ’Total federal tax withheld for employee : * 

8 10 

underlined TAXSUM 8 50 

skip 2 lines 

place "Average federal tax withheld : • 8 10 

underlined AVGTAX 8 45 

skip 2 lines 

group by PAGE 
header is 

place TITLE 8 15 skip 3 lines 

place ’ * 8 15 


skip 2 after 


footer is 

place ****** 8 5 skip 4 lines 

place FOOTNOTE 8 9 skip 0 


group by D NUMBER 
header is 

place *********** Department : “ 
DNUMBER 8 28 

’•*««******* 8 32 


8 5 


footer 

place "Department tax withheld total : * 85 

underlined TAXSUM 8 37 skip 4 lines 
place ’Department employee average income : ■ 85 

underlined AVGPAY 8 43 skip 2 lines 
sort by descending DNUMBER 
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10/13/1983 


PAGE 1 


Honthly Employee Dets i l Repor t 


***«**-■■***. Dep artment -5 


Department no: 


Employee name: Erica Poe 


Social security no: 332-55 -el95 


Past ion exper i ences : 

techn j.C3l_3dvj i sgr 

p r oduc t x on _ auger vj.sgr__ 

aUST?^l!!_3DilIl»'3*C 

Skill code : 2542 Jofccode: 51 


rear to date earning: 24000.00 


Federal withheld tax : 2300.00 


Department tax withheld total : 2300^00 
Department employee average income : 2 * 


►samp 15 . rdl 
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10/13/1983 


PAGE 2 


flonthly Employee Detail Report 


•***%* Oep artMSnt 5 
Department no-' 5 


Employee name; Silver Knight 


Social security no; 37&-‘to-8364 


Past ion e:;per i ences : 

c lerk 

postal _carr i er 

author ~ 

Skill code; 176e Jobcode: -.2 


i ear to date earning: 21000.. 00 
Federal withheld ta:: ; 2000.. 00 
Department no; 5 


Employee name: Charles Orupenhoff 


Social security no: 562-73-12o3 


Past job e::per i ences : 

clerk 

cashier 

Programmer 

Skill code: 2563 Jobcode: 41 


;*3r to date earning: 12000^.00 


**samp 15 . rd l 
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10/13/1983 PAGE A 

monthly Employee Detail Report 


Department no; 4 

Employee name 1 Carl Guelman 

Social security no: 659-56-9876 

Past ion experiences: 

magj.c j.an 

coined i an 

Skill cade: 2653 Jobe ode: Si 

tear to date earn i no : 11200.00 

Federal withheld ta:: : 1020.00 

Depart merit no: e 

Employee name: Jannie Houard 

Social security no: 342-89-1111 

Past job experiences: 

account ant 

I!i'5_10y5aiiu22SC 

bank ..'txann ner 

Skill code: 2326 Jobe ode* 30 

i ear to date earning: 42000,00 

itt-'Ssiup 15 . r dl 
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10/13/1983 


PAGE 7 


donth ly Employee 

Oeta i l Report 

Federal withheld t a : 

: 890.00 

Department no: 2 


Employee name: Kirk 

Komm i c k 

Social security no: 

87.6-43-8219 

Past lot? experiences: 
market analyst 

nurs«s 

c i v i l end i neer 
3k i l l code : 1852 

Jobcode: 14 

Tear to date earning: 

1 4000 . 00 

Federal withheld tax 

: 1300.00 

Department no: 2 


Employee name: Aaron 

Gal an ad 

Social security no: 

231-45-3219 

Past jot? experiences: 


QC!23C'3t> , !!§C 

2 ' 9 iynteer_£ 1CS!S3D 

12astry_cr,*f 

Skill codi! 3305 JoBcodei 13 


fear to date earn mas 11300.00 


^ssmp 1 5 . rd l 
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Plonthly Employee Detail Report 


Federal withheld tax : 1030.00 

Department no: 2 

Employee name'- Burton Backoff 


Social security no: 873-56-1432 


Past ioh e::per i ences : 

3254 *!i! -.523 J.Q§:cC 

P.C83C ammer 

cost _cgntro_i _ler 

Skill code: 1203 johcode: 12 


rear to date earning: 32000.. 00 
federal withheld tax '• 3100,. 00 
Department no: 2 


Employee name: Francine Fransmeier 


Social security .no: 126-35-7123 


Past lots exper i ences: 

3USiS!l , _2C23C3E , !l , SC 

accountant 

EC2 JS£i_§D.§iiJ2£ 

Skill code: 2029 Johcode: n 


rear to date earning: 23000.. 00 


* wee samp 15 . rdl 
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10/13/1933 


PAGE 10 


nonthly Employ** Detail Report 


•>**■» Department 1 


Department no-' 


Employe* name: Gould ftciiullan 


Social security no : 562-44-8743 


Past iop experiences: 

park manager 

5sles_cierk 

Is'i yCi iy_deputy 

•kill cod*: 2508 Johcode: 

rear to date earning: 13000^00 


federal withheld la.: : 1200.. 00 


Department, no: 


Emp lOye* name 1 Leo 


Gramsttd 


Social security no: 765~o5~733.l 


Past iot> experiences: 

?B.3Cli!!iSS3i_l!!aa29§C 

handyman 

csrgenter 

Skill cod*: 2745 JOhcod*: 3 


fear to date earning: 10000.00 


<--**s3mp 15 . rdl 
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10/13/1933 PAGE 11 

Plonthly Employee Detail Report 


Federal withheld tax : 900. 00_ 

Department no: 1 

Employee name: Boh Ammes 

Social security no: 237-87-7521 

Past ion experiences: 

singer 

'^Sl*2Q9 l 7e_dgeratgr 

talk_ anou_hgst 

Skill code: 1011 Johcode: 3 

fear to date earnmq: '?00 0*00__ 

Federal withheld tax : 300*00 

Department no: 1 

Employee name: Oeanna Anderson 

Social security no: 653-3e-7455 

Past ioh experiences: 

'UC^ilS-ihgtructgr 

FBI_f ield_j.nvestj.gator 

anj_mal _tr aj_ner 

Skill code: 1130 Johcode: 2 

i ear to date earning: 11000*00_ 
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10/13/1983 


PAGE 12 

rtonthlij Employee 

Detail Report 


Federal withheld tax : 

1000.00 


Department no: 1 



Ernp log** nam* : David 

Ahrendt 


Social security no: 

123-34-9875 


F'ast job exper i ences : 
po l ics off i car 



daric: ar 



boxer 



Skill coda : 1100 

Jobcode: 1 


resr to data aarninq: 

15000 . 00 


Federal withheld tax : 

1 400 . 00 


D*p srtwant no! 1 



Eniol oyaa nama: David 

Ahrendt 


Social security no: 

123-34-9375 


Past 10 b ax par i ancas : 
polica off i car 



dancar 



boxer 



3k i 1 1 coda : 1030 

Jobcode: 1 


raar to data aarninq: 

15000 . 00 


3(,id 15 . rd l 
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donthly Employee Detail Report 


Federal withheld tax : 1400.00 


Department no: 


Employee name: David Ahrendt 


Social security ho: 123-34-9873 


Fast |oh experiences: 

52ii£S_d££3£er 

danc er 


Skill code: 1001 


Johcode: l 


'ear to d3te earninq: 15000.00 


Federal withheld tax : leOO.Ot 


Departiiieht tax withheld total ■ 5300 . 00 


Department employee averaiie income : 11*00.00 


-»e = 3 i„p 1 5 . r d l 
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The following are keywords in the Report Definition Language. 
Data items, record types, and sets in a data base being accessed 
through RDL cannot have any of these keywords as their names. 
Functions and user-defined variables should also avoid conflicts with 
these keywords. 


ACROSS 

FILE 

PERCENT 

AFTER 

FOOTER 

PLACE 

ALIGNMENT 

FOR 

PRINTER 

AND 

FROM 

PROGRAM 

ARE 

FUNCTION 

PROMPT 

ASCENDING 

GE 

REAL 

AT 

GROUP 

REPORT 

AVERAGE 

GT 

RETURN 

AZ 

HEADER 

SCREEN 

BEFORE 

IDEC 

SIZE 

BIN 

IF 

SKIP 

BINARY 

INT 

SORT 

BREAK 

INTEGER 

STDDEV 

BY 

IS 

STR 

CASE 

LE 

STRING 

CHAR 

LEFT 

SUM 

CHARACTER 

LINES 

SUPPRESS 

CLEAR 

LT 

TEST 

COMPUTED 

MARGIN 

THEN 

COUNT 

MAX 

THRU 

DATABASE 

MIN 

TIME 

DATE 

NAME 

TOP 

DECIMAL 

NE 

UNDERLINED 

DEFAULT 

NOT 

UNIQUE 

DESCENDING 

OF 

UNSIGNED 

DEVICE 

OR 

USER 

DISPLAY 

OTHERWISE 

VARIABLES 

DOWN 

PAGE 

WITH 

ELSE 

PAGES 

XOR 

EQ 

PAUSE 

ZA 
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See Chapter III for a detailed presentation of the RDL. 

NOTATION: 

An underlined expression must appear. 

Zero or one of the alternatives within 
the brackets must be used. 


Exactly one of the alternatives within 
the braces must appear. 


One or more of the alternatives within 
the braces must appear. 
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ORDERING OF RDL SECTIONS: 

Identification Section 
Prompt Section (optional) 

Output Control Section (optional) 
Function Definition Section (optional) 
Computed Variable Section (optional) 
Report Detail Section 
Group Section (optional) 


RDL SECTIONS: 


1. Identification Section 


DATABASE FILENAME IS lfll&-ll 
[u£ER IS m WITH {.EH!,} 

[EBQGBAM FILE IS IfilQ-lf] 
ISGBEEN GROUP IS idzll 


2. Prompt Section (optional) 


EEQMEI VARIABLES ARE 


r 




rr 




K 


idrl- 


UNSIGNED 

BEAL 

INTEGEE 

INI 

BINABI 

BIN 

CHAEACTEE 

CBM 

SIBINC 


r infcrl 


^SIB 


J 



s (DECIMAL! iaf-1 l , int-3 3 

I jlDEC j 

i TIME 

VJ2A1E J 




V 


r"strinsz:2^ 

DEFAULT UDtrl 




J 


B-2 
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3. 


Output Control Section 


r PAGE SIZE 



LINES] 


LEFT MARGIN 



TOP MARGIN 


int-3 1 
id =1 I 


— 

-PRINTERS 

— 

DEVICE , 

SCREEN 

"file-1" 

► 





[ PAUSE AFTER PAGE] 


[ SUPPRESS DATE PAGE] 


ALIGNMENT. PAGES 



4. Function Definition Section (0, 1, or more per 

specification) 


ENNCTXQN id =1 IK id-2, 1*1] typ e-1 size-1 




r 


< 


{id - 2, > 




< 


)> int-1 


r UNSIGNED ^ 
REAL 
INTEGER 
I NT 

BINARY 

BIN 

CHARACTER 
CHAR 
STRING 
V STE 


int-2,Lxiai-31 






J 


TIME 

DATE 


V 




J 


i procedure-1 1 


RDL 
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id-1 t yp e . 


6 . 


r 






Computed Variable Section (optional) 


COMPUTED VARIABLES ARE 

r 




JL s.iag-1 


IZQR (condition-1) ] < 


r 

SIM 

AVERAGE 

MAX 

MIN 

COUNT 

STDDEV 

PERCENT 


> ( ARGUMENTS-1 ) > 


function-1 [ (arguments-2) ] 


1 


J 


Report Detail Section 


REPORT 


ELACE {UNIQUE UNDERLINED expression-1 ( FORMAT n tmt n ] 


£ in t- 1 

iatn4. ACROSS (FROM ( in t- 5..x i n t rS) 1 £ int-7 ( { . int-8) 
uom (FROM U nt - 3xintrl Q ?J £ int-11 



int-2 [LINES BEFORE ( int-3 LINES AFTER] ] 
int-3 LINES AEIER 



} 


J 


tEQR 1 condition;:! 1] 

thru { (-] [>1 set-1 ,1* 


— . 

r 

[“ASCENDING 1 

•S 


SORT BY ] 

V- 

AZ 

DESCENDING 

ZA 

{id-2J* 

> 

> 


B-4 Rev 


85A 
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7. Group Section 


[PAGE BREAK AT idnl] 


[REPORT^ 
•{GROUP BY { PAGE. f 

lid-2 J 


PELAGE [UNIQUE UNDERLINED expression-1 [FORMAT ?.£ mt." 1 


A 


HEADER IS<( 


£ ilLtL-l * 

in.tr 4 ACROSS [FROM ( int-5 . int-6) 3 £ int-7 [ Ui nLz&l 1 
DOME [FROM (intnS,Jjltrl£11 £ int-11 

SKIP f int-2 [LINES BEFORE [ int-3 LINES AFTER]] 1~1 ) 
l int.-3. LINES AFTER J J ■> 


J V 




PLACE 


FOOTER IE < 






[unique underlined axgtaaa.ifl.nnl [eormat "frot"! 

[£ intrli * 

int-4 ACROSS [FROM ( int-18 . int-19) ] £ int-20 [{.int-21> ] 

* 

> 

DOWN 

[FROM (int-22, int-23) ] @ int-24 



SKIP . 

int-15 [LINES BEFORE [int-16 LINES AFTER] ]1 

] 



intrJL.6. LINES AFTER j_ 

i 

J 









"ASCENDING 

> 



SORT GROUPS BY <{ 


AZ 

DESCENDING 
_ZA _ 

{id-3}* 

> 

> 



J 


J 
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access codes 

assignment statement 

break statement 

C source code 

character class matching. . . . 

clauses 

clear console screen 

command file. ... 

command status messages . . . . 

comments 

computed variable section . . . 

computed variables 

conditions . . 

console screen output 

control structures 

data base 

data items 

data relationships 

data values 

dates 

disk file output 

DML 

DMS/SMS loading 

duplicate value suppression . . 

end user 

errors detected by RDL Analyzer 

expressions 

footers . 

function definition section . . 

function parameters 

functions 

group section 

grouping 

headers 

identification section. . . . . 

if-then-else statement 

interaction 

literals 

local variables 

margins 

MDBS Data Management System . . 

operators, arithmetic 

operators, logical 

operators, relational 

output control section. . . . . 

page 

page breaks .......... 
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page numbers 

page size 

pause after page 

preprinted form alignment . 

printer outputs 

procedures. 

program compilation .... 

program execution 

program files 

program generation 

prompt section 

prompt variable 

QRS 

RDL Analyzer 

RDL library 

RDL sections 

RDL specification 1 

repeating data items. . . . 
report. .......... 

report designer ...... 

report detail section . . . 

report details 

report header pages .... 

report layout 

return statement 

schema 

screen dictionary 

screen group 

SCREEN MASTER 

screens 

sets 

skipping lines 

SML ............ 

sort-merge processor. . . . 

sorting 

spacing between columns . . 
statistical functions . . . 

terms 

test-case statement .... 

THRU clause 

underlining 

unique qualifier 

user name 

user password 

wildcard matching 

windows .... 


5,13,15,19 

5,13,17,34 

. 18 

...e................ 19 
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. . . . 45 

46 
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1 
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25 

1,32,53-55 

. . . . 5,12,13,30,37,40 

12,13,30,37,40 

1,5,12,46 

. 5,13,17,18,30,37,38,40 

8,32,33 

...... .28,29,36,38 

... 1,4,46 

43 

. . . .3,7,8,28,33,35,41 

28,29,37 ,39 

3,6,26 

10 

24,25 

3,32 

29 

29 

2,9,12,15,43 

2,9,12,15,43 

23 27 31 

1 5,13,17,18,30,37 [ 3 8 ^ 40 
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DOCUMENTATION COMMENT FORM 


MDBS Document Title: 


We welcome and appreciate all comments and suggestions that can 
help us to improve our manuals and products. Use this form to 
express your views concerning this manual. 

Please do not use this form to report system problems or to 
request materials, etc. System problems should be reported to 
MDBS by phone or telex, or in a separate letter addressed to the 
attention of the technical support division. Requests for 
published materials should be addressed to the attention of the 
marketing division. 


Sender : 


(name) 


(position) 


( company) 


(telephone) 


(address) 


(city, state, zip) 


COMMENTS: 

Areas of comment are general presentation, format, organization, 
completeness, clarity, accuracy, etc. If a comment applies to a 
specific page or pages, please cite the page number(s). 


Continue on additional pages, as needed. Thank you for your response. 



